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PRIM  SYSTEM:  AN/UYK-20  USER  GUIDE 


INTRODUCTION 

The  PRIM  system  supports  UYK-20  program  development  and  testing  by  providing 
an  emulated  UYK-20  tool  embedded  in  an  interactive  time-sharing  environment.  This 
emulated  UYK-20  provides  powerful  debugging  aids  not  possible  on  an  actual  UYK  20 
computer  system. 

Ihis  guide  consists  of  two  sections,  serving  distinct  purposes.  This  first  section  is 
an  extended  introduction  to  the  PRIM  UYK-20  tool  and  Its  capabilities;  It  is  addressed  to 
the  UYK-20  user  with  no  prior  exposure  to  PRIM.  It  consists  of  an  overview  of  the  tool, 
followed  by  a detailed  discussion  of  a number  of  common  or  representative  programming 
problems  with  solutions  illustrated  by  means  of  actual  session  transcripts  with  the  PRIM 
UYK-20  emulation  tool.  The  second  section  is  an  appendix  to  a separate  document,  77ir 
riUM  Sysirm:  Ihcr  Mnnuni,  that  manual  and  the  appendix  together  constitute 

the  complete  reference  document  for  the  PRIM  UYK-20  tool.  (The  PRIM  system  supports  a 
family  of  emulation  tools;  the  Un(jr  Hcf'erauca  Manual  covers  the  capabilities  of  the  PRIM 
system  as  they  apply  to  all  the  tools  in  general.) 

PRIM  is  available  through  both  the  NSW  (National  Software  Works)  and  the  USC-ISIC 
11  NCX  system,  which  is  a server  system  on  the  ARPANtT.  Ihe  user  of  PRIM  is  assumed  to 
have  access  to  one  or  the  other  system  and  some  rudimentary  familiarity  with  its  use. 
Once  the  user  enters  f’RiM,  its  behavior  is  identical  in  the  two  environments. 

f 

PRIM  consists  of  the  emulated  UYK-20  plus  two  separate  command  interpreters 
known  as  the  exec  and  the  debugger.  At  any  time,  PRIM  is  either  running  the  UYK-20 
emulator  or  processing  user  exec  or  debugger  commands;  the  transition  between  states  is 
at  the  control  of  the  user. 

Fvee  commands  are  concerned  primarily  with  the  manipulation  of  UYK-20 
environments  and  configurations.  Ihe  elements  of  exec  commands  are  keywords,  file 
names,  and  (decimal)  numbers.  Keywords  include  such  ilems  as  command  names,  device 

names,  options,  and  parameters.  Ihcy  need  not  be  entered  in  their  entirety;  any 

unambiguous  leading  substring  of  the  desired  word  suffices  for  recognition.  (When  a 
keyword  is  terminated  with  an  anr.npn  character,  the  word  is  completed  by  the  exec.)  MIc 
names  refer  to  files  in  the  user’s  file  space  (In  either  NSW  or  ILNEX),  and  follow  the 

appropriate  file  name  syntax.  Each  file  specification  requires  the  name,  as  appropriate,  of 

cither  an  existing  file  (to  be  read  or  modified)  or  a new  file  (to  be  created  and  written). 

Debugger  commands  are  concerned  with  the  detailed  control  of  the  emulated 
UYK-20.  Ihe  debugger  Includes  the  functions  available  on  the  front  panel  of  the  UYK-20 
as  a small  subset  of  Its  capabl!ltles.  Debugger  commands  each  consist  of  a single 
character;  the  arguments  to  those  commands  are  symbolic  expressions  which  name  the 
elements  of  the  UYK-20  (e.g.,  memory  locations,  registers,  PC,  channel  control  memory). 

Within  PRIM,  certain  ASCII  characters  have  been  assigned  special  functions  when 
input  by  the  user.  These  functions,  which  are  described  completely  In  the  Ihrr  Ht^fnouro 
Mnnualf  concern  command  editing  and  PRIM  (command  and  UYK-20)  control.  Ihe  command 
editing  functions  are  backspace  (either  hacknpaca  or  rnf/-/l),  backup  (ml/- IP),  delete  {del 
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editing  functions  are  backspace  (either  hnckapncti  or  rtui-/)),  backup  (rMif-ll  ),  delete  {dol 
or  ruhout),  retype  (riul-K),  and  question  {qu<*mion-mnrk)‘,  the  control  functions  are  status 
(rntl-S)  and  abort  (cntl-X).  Backspace  backs  up  over  one  character  within  the 
current  field  of  a command;  it  is  acknowledged  by  a backslash  (\)  followed  by  the  erased 
character.  Backup  backs  up  over  the  current  command  field;  it  is  acknowledged  by  a 
backslash  (\)  followed  by  the  first  character  of  the  erased  field.  Delete  backs  out  of  the 
current  subcommand  entirely  (or  out  of  the  current  command  If  not  in  a subcommand);  it  is 
acknowledged  by  "XXX”,  followed  by  a new  prompt.  Retype  re-displays  the  current 
command  or  subcommand  line.  Question,  when  entered  as  the  first  character  of  a field, 
generates  a summary  of  the  input  currently  expected,  followed  by  a retype  3f  the  line. 

Status  causes  PRIM  to  respond  with  the  current  status  of  the  emulated  UYK-20. 
Abort  causes  any  operation  in  progress  to  be  cleanly  terminated  and  returns  control  to 
the  top  level  of  PRIM  (either  exec  or  debugger,  depending  on  which  one  last  had  control). 
The  abort  function  is  used  both  to  abort  a command  that  is  partially  entered  or  in  process 
and  to  stop  the  running  UYK-20. 

With  this  background  we  can  now  illustrate  how  PRIM  can  be  used.  Iwo  examples 
will  be  explored  in  detail;  these  examples  will  show  how  to: 

1.  key  in  a small  program,  run  it,  discover  a bug,  fix  the  bug,  trace  it  to  observe  its 
operation,  and  save  the  results, 

2.  load  a program  into  memory  from  a paper  tape. 

Several  rurthcr  examples  will  be  presented  with  considerably  less  detail  to  illustrate  a 
number  of  ways  in  which  the  interactive  PRIM  debugger  can  be  used.  These  examples  will 
show  how  to: 

1.  find  which  instructions  are  modifying  a location  and  which  ones  are  setting  It  to  a 
designated  value, 

2.  determine  how  many  times  a code  sequence  is  executed  and  how  many  times  a data 
location  is  referenced  prior  to  the  occurrence  of  a known  condition, 

3.  trace  a loop  only  once, 

find  which  instructions  in  a program  were  not  executed, 

5.  test  If  a data  location  has  changed  over  a code  sequence,  and 

6.  search  a buffer  for  a given  value. 

In  the  following  examples,  drawn  from  actual  PRIM  session  transcripts,  user  input  is 
Unlirizod  to  distinguish  it  from  machine  output.  Input  control  characters  appear  as 
their  abbreviations  superscripted  (e.g.,  ^*^). 
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ENTER  AND  DEBUG  A SMALL  PROGRAM 

To  start,  let  us  follow  a complete  step-by-slep  sequence  of  interactions  with  PRIM. 
Wc  shall  enter  a small  program,  debug  it,  then  save  the  resulting  memory  image  on  a disk 
file  for  later  use. 

Our  session  begins  with  a command  which  requests  the  PRIM  UYK-20  tool.  From 
IFNFX,  we  begin  at  the  exec,  whose  prompt  character  is  "fD". 
e<PK/Af>(/yK20" 

RN/UYK-20  (20/84/77) 

Latest  NLUS  Is  28-JUNE>77 
> 

From  NSW,  we  begin  at  the  front  end  with  the  equivalent  command. 

NSUt  u^^^SSE  (tool  nam«d)t  uyk20^*rt  (conflrn)t 
you  Mill  now  bo  talking  to  1UY)C20 


nN/UYK-20  (20/04/77) 
latost  NEUS  Is  28-JUNL-77 
> 

In  either  case,  the  UYK-20  tool  is  loaded,  publishes  its  greeting  message,  and  enters  the 
PRIM  exec,  whose  prompt  character  is  V.  The  greeting  includes  two  dates.  The  first  is 
the  release  date  of  the  current  version  of  the  UYK-20.  the  second  is  the  date  of  the 
most  recent  item  of  on-line  news  (these  on-line  items  may  be  accessed  via  the  exec  NEWS 
command,  which  is  not  demonstrated  here);  news  items  cover  both  new  releases  of  the 
UYK-20  and  changes  to  PRIM  commands.  The  remainder  of  the  session  — until  we  leave 
the  UYK-20  tool  at  the  end  of  the  session  - is  the  same  for  both  systems. 

We  direct  the  exec  to  keep  a transcript  of  this  session  on  a file,  and  then  switch  to 
the  PRIM  debugger,  whose  prompt  character  is  V,  for  the  bulk  of  this  sample  session. 

>77^(?5rpNSCRIPT  (to  fiio) 

>/r-<^EBUG 

i 

7 he  exec  creates  and  opens  a new  file  named  EXAMPLE  and  records  the  remainder  of  the 
PRIM  session  on  that  file  for  subsequent  reference  by  the  user.  Note  that  the 
TRANSCRIPT  command  Itself  is  not  actually  found  in  the  file  since  transcription  begins  only 
after  the  command  Is  completed;  it  has  been  edited  into  this  example. 
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For  the  transcribed  record,  we  enter  several  lines  of  comments,  precedir  g each  with 
the  PRIM  comment  character  tcmic.olon. 


ii  Houtittc  to  march  a tortcd  tahlo 

t;  by  tucccunvc  halving  then  tciccling  the  half  thal^f 

i;  ihould  contain  the  given  numherS^ 


i;  rr 


•l 


/Jrceptit:^^ 

reg  2 the  addrem  of  the  firtt  element  in  the  tahle^’^ 

reg  3 the  addrem  of  the  lant  element  in  the  tahle^*' 

reg  4 the  number  to  find  in  the  tahle^*‘ 

reg  IS  the  return  addreti^^ 


f*  r.r 

i;  KetnrnicS^ 

i;  reg  I the  addreMM  of  the  element  in  the  table  matching 
f;  the  contentt  of  reg  4 or  0 if  not  found^*" 

#Afod«  Kxpand«d>l  ln«i 


#7yp«  0t000^»f' 


oioeoi 

00  • 

IM  l..1\ 

OlOOlt 

00  > 

SUK  l.2\ 

010021 

00  - 

U.KS  l.t\ 

01003: 

00  > 

/IK  l,2\ 

01004: 

00  > 

Cl  i,l\ 

01005: 

00  ■ 

JKK  /S\ 

01806: 

00  ■ 

I.JCK  $*3\ 

01007: 

00  « 

I.K  2,l\ 

01010: 

00  • 

IJ  S.2\ 

01011: 

00  - 

I.K  3.l\ 

01012: 

00  * 

CK  2.3\ 

01013: 

00  * 

I.JNK  0t000\ 

01014: 

00  - 

SUK  l.l\ 

01015: 

00  > 

JK  <5" 

i;  /]  tmall  program  to  call  the  routine:*^*' 

#7’ype  0l200f^»c 
012001  00  . l.K  2,0I300\ 

01202t  00  ■ l.K  3,0I307\ 

01204  j 00  . J/.H  IS,OIOOC\ 

012061  00  « JS  01200^*’ 

#;  The  ordered  lint  of  nnmberg:^*’ 

#7yp«  0l300^^f' 

0130OJ  00  c 0,2,4,7,9,20,80*100^'' 

Prior  to  entering  the  subroutine,  we  instruct  the  debugger  to  produce  Its  output  on 
separate  lines  using  the  Mode  Expanded-lines  command.  (In  the  other  choice,  known  as 
Dense-lines,  the  debugger  compacts  several  lines  of  output  into  one.) 

We  begin  building  our  ibroutine  at  location  01000  (leading  zeroes  indicate  octal 
numbers)  by  entering  a type  command  with  the  desired  address  and  terminating  with  an 
escape.  In  response,  the  debugger  displays  the  contents  of  location  01000  fo!!oy/ed 
by  an  equal  sign  to  allow  replacement.  At  this  point  we  enter  the  first  instruction  of  the 
subroutine  followed  by  backgla»h.  The  debugger  assembles  and  deposits  the  Instruction 
at  location  01000.  It  then  displays  the  next  available  location,  01001,  for  replacement.  In 
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this  manner,  successive  instructions  are  deposited  into  successive  locations.  We  type  a 
miirn  after  the  last  instruction  to  terminate  the  type  command. 

Following  the  subroutine,  we  enter  a small  main  program  and  a data  table  for  testing 
the  subroutine.  The  list  of  numbers,  "0,2,^,...",  each  go  Into  separate  consecutive  cells. 

lo  begin  the  test,  we  load  register  ^ with  ■ number  the  subroutine  Is  to  search  for 
--  in  this  case  80  - then  begin  UYK-20  execution  at  location  01200. 

tSmi  r Rorr 

tCo  do)  0l200^r 

Hfliifid  from  ei?e6i  js  ei?oe 

- > pN/UY):.?e  hAitfld  At  ei?ee,  u««d  aiee.a 

#7’ype  HiiH.Vr 

Rit  eo 
R?t  01.100 
R3i  01300 

♦7'ype 

01300]  00 

Within  a short  time,  the  emulator  halts  after  executing  the  JS  instruction  at  location  01206 
and  control  returns  to  the  debugger.  We  Inspect  registers  R1  through  R3.  Register  1 
contains  a 0 indicating  the  subroutine’s  failure  to  find  the  value  80  in  the  table.  Closer- 
inspection  reveals  'hat,  while  register  3 should  point  to  a value  in  the  table  greater  than 
80,  it  does  not.  'ho  "<«>*'  is  a unary  operator  meaning  contents-of;  the  last  type  command 
above  uses  the  operator  to  inspect  the  location  addressed  by  R3  without  having  to 
enter  the  actual  v.dd'css. 

Armed  with  th's  information,  we  place  a breakpoint  at  the  LJGE  at  01006  to  gain  a 
closer  view.  Wc  then  restart  the  main  program. 

fltr9»k  («|)  01006^^*'  *Afl*r  doing)  Xecutt 

tCo  do) 

- > Broak  alter  axecMtlng  0100F-.  LJGE  01011 

tU 

-->  Step  from  OI007i  IR  02,01 

#7’ype 

01300]  00 

0)303]  07 

The  break  command  instructs  the  UYK-20  to  break  --  suspend  execution  and  return 
control  to  the  debugger  --  after  every  subsequent  execution  of  an  instruction  at  01006. 
So,  when  the  emulator  finishes  executing  the  conditional  branch  (whether  it  branches  or 
not)  control  passes  back  to  the  debugger.  At  this  point  in  the  subroutine  ttie  location 
addressed  by  the  contents  of  register  1 should  have  been  compared  and  found  to  be  less 
than  80  (register  ^).  Consequently,  the  subroutine  should  now  search  the  Interval 
between  the  address  in  R2  and  that  in  Rl.  In  other  words,  the  address  in  R1  should 
replace  R3  and  the  search  repeated.  We  single-step  the  UYK-20  using  the  liuc-frcd 
command  and  find  that  as  the  routine  has  been  written,  Ri’s  contents  replace  R2  which,  in 
effect,  choosos  to  search  the  other  half  of  the  interval. 
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Ihc  solution  is  clear;  wo  replace  the  instruction  LJGE  at  01006  vit  i an  LJLS 
instruction.  We  reset  register  2 to  the  correct  value  and  restart  the  subroutine  at  the 
comparison. 

#AfodQ  /ns (ruction  f#7yp«  0i006^*^ 

eieoGt  I ICE  eieii  - I.JIS 
f7yp« 

R?i  ej3oo  . (R>K.7\ 

R3i  01303  - 0/.7t)7" 

#G’o  (to) 

• > Rr«Al(  ollor  OKocullny  61606t  LJIS  11611 

gff 

• > Slop  from  016071  LR  02,01 
#7'ypo 

6130SI  024 

01307t  6144 

f/lehroAk  (from)  01006*^^ 
iCo  (to) 

>->  HAltod  from  61266i  JS  61266 
- > nN/UYK-?0  hAltod  At  01260,  Ucod  0166. • 

#7ypo 

01306:  0176 

Again  the  breakpoint  is  reached  and  the  program  suspended.  We  single-step  another 
instruction  and  observe  the  expected  behavior  of  our  subroutine.  The  breakpoint  Is 
removed  and  the  routine  is  continued,  eventually  halting  at  the  end  of  the  main  program. 
Inspection  of  register  1 reveals  that  the  routine  was  successful  In  finding  the  desired 
value. 


For  the  seconJ  test,  we  prepare  the  subroutine  to  search  the  table  for  a value 
known  not  to  exist.  After  execution,  several  seconds  elapse  without  any  response  from 
the  program.  We  request  and  receive  the  status  of  our  program  by  typing  tS  (which  is 
not  echoed).  Suspecting  the  program  to  be  looping  infinitely,  we  type  1 X to  suspend  Its 
execution. 

#5.1 

iOo  (to) 

— > RN/UYr-20  running  At  61616,  Us.d  6:66.9 

TX 

- > RN/UYX-20  ini.rrupl.d  from  running  At  61660,  Used  6:61.6 

#7’yp.  HI:K,rr 
Rlt  61301 
R2i  01360 
R3:  01301 

Our  inspection  reveals  that  registers  2 and  3 correctly  point  to  values  In  the  table  less 
than  and  greater  than  I;  the  state  of  this  program  seems  correct.  So  we  must  dig  a bit 
vurther. 
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We  build  a break  program  to  print  registers  1 through  3 after  the  execution  of  each 
UYK-20  instruction.  This  allows  us  to  observe  the  changes  In  the  registers  after  each 
instruction  execution. 

(«t)  .srh:p^^^ 

##A/ode  /Jon»«-llnes  #f#7yp* 
i0f'r 

<Progrjim  number  Is  [11>  iCo  <lo) 

. > Rli  ei  R?i  61318  R3t  61381 

— > Step  from  818611  SUR  81,62 
iCo  (to) 

- > Rli  66  R2i  61306  R3t  61361 

— > Slop  from  610021  LLRS  61,81 
fCo  (to)  " 

>->  Rli  61306  R2i  61306  R3t  61361 

— > Step  from  61603i  RK  61,62 
fCo  (to) 

>->  Rli  61300  R2i  61306  R3t  61361 

-->  Step  from  6ie04i  Cl  64,61 

The  name  .STEP  is  associated  with  the  singis-step  event,  Instructing  the  UYK-20  to  break 
after  every  instruction.  The  e%capo  following  .STEP  indicates  that  we  wish  to  associate  a 
break-time  program  with  the  occurrence  of  iiiis  breakpoint.  In  response  to  the  "fttt" 
prompt,  we  enter  successive  debugger  commands  which  are  not  executed  now,  but  rather 
saved  by  the  debugger  to  be  executed  when  the  breakpoint  occurs;  the  break  program  is 
terminated  by  an  empty  input  line.  Each  subsequent  Go  then  executes  exactly  one  more 
instruction,  followed  by  the  break  program. 

After  executing  a few  more  Instructions,  we  are  able  to  determine  the  problem. 
The  addresses  in  register  2 and  3 differ  by  1.  When  the  routine  computes  the  address 
halfway  between  them,  truncation  occurs  resulting  In  an  address  identical  to  that  In 
register  2.  The  value  in  the  table  at  tf»is  address  is  compared  with  1,  found  to  be  less 
causing  its  address  to  be  placed  in  register  2.  Since  the  old  address  In  register  2 Is 
identical  to  the  new  one,  no  progress  Is  made;  the  comparison  for  equality  between  the 
contents  of  registers  2 and  3 fall  and  the  routine  jumps  back  to  01000  to  continue  -- 
causing  the  infinite  loop. 

To  correct  this  condition,  we  replace  the  section  of  code  in  the  subroutine  which 
updates  register  2 or  3 to  decrease  the  distance  between  the  values  by  one.  We  restart 
the  program. 

iModa  /nstruction 
#7ype  OlOOO^^f' 


01606: 

LJLS  01011  « LJLS  $^4\ 

61007: 

LR  02,01  = I.K  2,IJ\ 

OlOlli 

LR  03,01  « /J  JOX 

01612: 

CR  02,03  r I.K 

61014: 

SUR  01,01  - CH  3,2\ 

01015: 

JR  017  = UPS  0I000\ 

01016: 

60  . SUH  u\ 

61617: 

00  . JH 

#Debrealc 

(from)  all  (confirm)®** 

"o 

o 

0/200®** 

When  the  program  again  terminates,  we  examine  register  i and  find  that  the  routine  has 
correctly  failed  to  find  a nonexistent  value  in  the  table. 
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Satisifed  with  our  program,  we  aavo  the  core  Image  on  the  file  BINSRCH.MEM  and 
terminate  our  PRIM  session. 

>>  Halted  from  012861  JS  01200 
>->  HN/UYK-2e  halted  at  01200,  Used  OiOl.O 
#7  ypa  H 
Rl:  00 

fReturn  Wo  EXCC)  C'' 

>S'/I^*^VE  ? One  oT  the  foiloHlngi 
RIL 

CONnCURRTION 

nfflORY 

SYnBOLS 

>SflVE  Af^*»^EI10RY  (on  file)  IIINSRCILMEM;!^*" 

>(iearuiT 

Quitting  flN/UYK-28  (Confirm) 
e 

The  file  BINCRCH.MEM  now  contains  a UYK-20  memory  Im  ge  that  c:)n  be  retrieved  for 
subsequent  use  with  the  exec  RESTORE  command. 


OOTtrRAP  A PROGRAM  FROM  PAPE1  TAPE 

This  example  will  demonstrate  the  process  of  loading  a program  from  paper  tape 
using  the  bootstrap,  ‘oader. 

The  bootstrap  program  we  need  is  the  STANDARD  NDRO,  which  is  one  of  the  NDRO’s 
available  In  PRIM.  This  bootstr.^p  assumes  the  existence  of  the  1532  input/output  console 
on  channel  1.  Since  the  Initife!  machine  configuration  contains  no  I/O  devices,  we  must 
somehow  Install  the  conso'e. 

there  are  two  methods  av.3llable  for  attaching  devices  to  the  emulated  UYK-20. 
the  Jirst  Is  to  retrieve  the  device  assigments  from  a previously  saved  PRIM  sesc‘on  using 
the  RESTORE  command.  The  second,  which  we  will  use,  specifies  each  device  inoividu'illy. 
In  either  case,  the  ii  ctallation  of  I/O  devices  muiT  be  done  before  the  e ecution  of  any 
UVK-  20  program  in  that  session. 

>sicrf'r 

»NDR0«s'5  ? STh.rORPQ  or  SSIXS-fl 

»NDR0  cr 

»rr 

(device)  (CHANNEL) 

For  the  RERDER-1532, 

»SPKK*^^^'D  (character!  per  tecond)  1000^*" 

»rr 

For  the  PUNCH-i532, 

»rr 

For  the  TTY-1532, 

»rr 

We  set  NDRO  to  STANDARD  and  install  a 1532  on  channel  1.  During  the  Installation  of  the 
1532,  wc  are  prompted  for  parameters  for  each  device  connected  to  the  controller. 
These  parameters  allow  the  user  to  specify  device-dependent  information.  For  simple 
devices,  as  In  this  case,  the  only  user- alterable  attribute  Is  the  speed  at  which  the  devices 
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operate.  (A  question  from  the  user  in  response  to  the  prompt  ”»'  will  elicit  the 
parameters  the  user  may  alter.) 

Wc  specify  the  SPEED  of  the  paper  tape  reader  to  be  iOOO  characters  per  second. 
In  tt  is  manner,  wc  are  able  to  significanlly  shorten  the  time  needed  to  read  the  paper  tape 
but  only  wilh  the  knowledge  that  in  this  application  the  bootstrap  program’s  operation  is 
independent  of  the  speed  of  the  paper  tape  reader.  If  we  do  not  set  the  speed,  PRIM  will 
automatically  select  the  actual  value  for  each  device.  Though  installation  may  only  be 
done  prior  to  execution,  device  parameters  may  be  altered  at  any  time  via  the  SET 
commmand. 

After  Installing  the  1532,  we  must  attach  a source  of  Input  to  the  paper  tape  reader. 
This  is  accomplished  by  ^ho  PRIM  MOUNT  command.  (The  punch  and  ITY  need  not  be 
mounted  until  needed.) 

(R,I,N,0L,0U,T,?)  ? Ont  of  fht  followingt 

RPPENO 

INPUT 

NiU 

OLD 

OUTPUT 

TMIS-TtRfllNnL 

>flOUNT  (R,I,N,0L,0U,T,?J  K^<'NPUT  (from  flit)  TKST./)11S;2*^^^  (on  dovict) 

K^*^E0nER.lS32 

»?  BINHRY  or  RSCII 

»/t*’^^INnRV  (Mith  bytt  cizt) 

The  second  word  of  the  command  (In  this  case  INPUT)  determines  the  direction  of  10  and 
whether  an  existing  or  new  file  name  Is  being  specified  (in  this  case,  wo  wish  to  read  from 
an  existing  file;  for  the  paper  tape  reader,  only  INPUT  and  THIS-TFRMINAl  arc  meaningful). 
Following  the  file  type,  we  supply  the  file  name,  TtST.ADS,  followed  hy  the  name  of  the 
device  on  which  to  mount  the  file  — READER-1532. 

Next  we  are  prompted  with  *’»'*  for  more  information,  In  this  case  the  format  of  the 
data  on  the  file  attached  to  the  device.  BINARY  N implies  the  data  file  is  to  be  treated  as 
a sircam  of  characters  in  wh’ch  all  eight  bits  of  data  are  significant.  The  bytesize,  N, 
describes  the  packing  of  the  inlormation  In  the  file.  For  disk  files  written  by  EMLOAD,  the 
UYK-20  loader,  each  byte  of  data  occupies  the  low  order  eight  of  thirty-six  bits  --  hence 
the  bytesize  Is  specified  as  36.  ASCII  specifies  a standard  7-lcvel  text  file;  the  bit 
corresponding  to  the  eighth  column  (parity)  will  always  be  zero.  If  neither  BINARY  nor 
ASCII  Is  entered,  the  default  (BINARY  36)  will  be  used. 
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Once  we  have  Installed  1532  and  mounted  a file  on  the  reader,  we  may  begin 
the  bootstrap. 

ts%  1 STOP  i,STOP2jmixio/in^>^ 

iCo  (to)  f'r 

— > Ha  I tod  from  866i  08 
— > nN/UYK>20  halted  at  078,  Usod  et88.4 
fKoturn  (to  EXEC) 

>S/lrT^rvE  M«?xrEnoRY  (on  (lit)  TKST.MEM;l^»f' 

>DescEBUC 

fCo  (to)  OlOOOf'r 

After  we  have  Installed  the  device  and  mounted  a file  on  it,  we  enter  the  debugger  and  set 
switches  BOOT2,  STOPl,  ST0P2,  and  LOAD,  which  correspond  to  similar  switches  on  the 
UYK-20.  (The  momentary  action  of  LOAD  Is  accomplished  by  having  the  emulator  clear  the 
switch  after  responding  to  It,  but  note  that  the  load  does  not  begin  until  a Go  command  is 
entered.) 

eventually  the  emulator  halts  after  reading  the  paper  tape.  Since  the  program  Is 
large,  and  we  intend  to  re-execute  It  in  future  sessions,  we  save  the  core  image  after 
loading  on  a new  file,  TtST.MEM,  where  it  can  subsequently  be  retrieved  via  the  RESTORE 
command. 

The  remaining  cxamp'es  will  be  much  briefer  than  those  presented  above.  Instead 
of  complete  sequences  of  interaction  with  an  actual  program,  just  those  commands  that  are 
necessary  to  solve  particular  problems  will  be  shown.  In  a few  cases  Intervening 
Interactions  have  been  edited  out  of  the  transcript  to  emphasize  the  essential  commands. 
In  general,  results  will  not  be  shown. 


FIND  WHICH  INSTRUCTIONS  MODIFY  A LOCATION 

A typical  debugging  problem  Is  finding  which  instructions  are  changing  a location 
(e.g.,  some  module  is  clobbering  a cell).  This  can  be  solved  very  easily  with  a simple 
brcaK-timc  debugger  program  which  traces  all  modifications  of  that  cell.  If  the  contents  of 
location  0123^5  are  being  changed  Improperly,  the  following  breakpoint  command  will 
Identify  all  subsequent  modifications  of  the  cell,  allowing  the  user  to  verify  their  validity. 

iHreflk  (at)  012345^*^  (after  doing)  IFrlte 
tffhf odB  /nstructlon  ###7'ypa  f^PCOLD^'^ 

#^7ype  OI23i5<'r 

iffCo  (to)  *'•’ 

<Program  number  ie  12) > # 

Ihe  debugger  commands  following  the  "ttu"  prompt  are  saved  as  the  break  program 
a^50ciated  with  the  writing  of  012345.  After  every  write  reference  to  that  location, 
UYK-20  execution  will  be  suspended  and  control  will  be  passed  to  the  debugger,  which  will 
execute  the  break-time  commands.  When  the  UYK-20  breaks,  PC  has  already  been 
advanced  to  the  next  instruction;  PCOLD  still  addresses  the  previous  Instruction.  Again, 
the  contents-of  operator  is  used  to  access  the  Instruction  location  in  memory.  Since  there 
is  a Go  command  In  the  program,  UYK-20  execution  continues  automatically  after  each 
break,  thus  generating  a trace  of  the  writes.  If  only  the  first  breakpoint  subcommand  had 
been  entered  (eliminating  the  type-out  of  012345  and  the  go  commands  on  the  third  and 
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fourth  lines),  then  after  displaying  the  instruction,  the  debugger  would  display  location 
01234b  and  stop  the  UYK-20  (thereby  returning  to  user  command  level). 


FIND  WHICH  INSTRUCTION  SETS  A LOCATION  TO  A VALUE 

A related,  and  perhaps  even  more  common,  problem  is  to  find  which  instruction  is 
setting  a known  (probably  improper)  value  into  some  location.  Ihis  can  be  accomplished 
with  a variant  of  the  break-time  debugger  program  presented  above. 

ilirmak  (at)  0i23iS^*^-  Caller  doing)  M^rllt 
##/f  12345  <>  <then>  i/nCo  (to) 

JifjffModo  /nstrucllon  #^#7ypo 

<Program  nurber  Is  13) > B 

Ihe  first  command  in  this  break  program  is  a conditional  command,  stating  "If  the  contents 
((fifl)  of  012345  are  not  equal  (<>)  to  the  value  067,  then  continue  UYK-20  execution  (Go)." 
When  the  Go  Is  executed,  the  remainder  of  the  break  program  is  ignored  and  UYK-20 
execution  resumes  immediately.  When  the  given  value  is  found,  the  Go  is  not  executed, 
the  break  program  is  completed,  and  control  returns  to  the  debugger.  Unlike  the  program 
above,  this  program  produces  no  output  until  the  tested  value  is  found  in  the  cell.  (Should 
we  forget  the  contents-of  operator,  then  the  value  012345  would  be  compared  to  ihe 
value  067  at  each  reference,  and  we  would  always  resume  execution.) 


DETERMINE  HOW  MANY  TIMES  A CODE  SEQUENCE  IS  ENTERED 

Occasionally  the  operation  of  a program  system  is  degraded  by  unnecessary  and 
unexpected  calls  on  subroutines  that  do  initialization  or  other  operations  whose  repetition 
do  not  cause  errors  but  do  affect  performance.  The  PRIM  Debugger  can  be  used  to  count 
the  number  of  times  a code  sequence  is  entered. 

In  the  following  example  the  code  sequence  is  assumed  to  start  at  location  01234, 
and  location  0100  (which  is  assumed  to  be  unused)  is  used  as  a counter. 

#Clear  OlOOf^r 

Bitroak  (at)  01234^^^  (after  doing)  Xecuta 

BBSoi  = ifoo/ao^K'' 

BBl'wpa  0100*^^" 

BBGo  (to) 

<Program  number  Ie  [41>  B 

Lvery  time  location  01234  is  entered,  the  count  will  be  incremented  and  displayed.  If  only 
a final  count  is  desired,  rather  than  a running  count  of  each  execution,  the  following 
command  could  be  used; 

#Clear 

Bitreak  (at)  01234^*^-  (after  doing)  Xecute 

BBSot  . oioo*rr 

BBGo  (to) 

BB^r 

<Pi  ogram  number  Is  [S]>  B 

#7ype  OlOO^f 
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COUNT  REFERENCES  PRIOR  TO  A DESIGNATED  CONDITIWi 

Ihc  efficiency  of  a process  can  sometimes  be  evaluated  by  the  number  of  times  a 
data  location  Is  referenced  prior  to  the  occurrence  of  a given  condition  of  interest.  A 
variant  of  the  previous  example  can  be  used  where  the  automatic  continuation  is 
conditional  on  the  designated  condition  not  yet  having  occurred. 

fClear 

#/frcftk  (at)  0 (after  doing)  Wead  H^rlta 
ffSet  - (R)0/00WC»‘ 

unh  fi>0^i32  <>  0^*^  <then>  ##fCr  (to)  cr 

ggcr 

<Prografn  number  Is  (6)>  f 
f'/'ypa  Of 00^** 

When  the  condition  that  location  05432  contains  a zero  occurs,  the  program  exeruticn  will 
break  and  the  counter  can  be  examined. 


TRACE  A LOOP  ONLY  ONCE 

With  the  PRIM  Debugger,  a program  trace  is  accomplished  by  setting  an  execute 
break  on  all  instructions  of  Interest  and  supplying  a break-time  debugger  program  that 
displays  the  most  recent  instruction  executed  (see  the  detailed  example  on  entering  and 
debugging  a small  program),  lo  trace  a loop  only  once,  the  continuation  can  be  made 
conditional  on  PC  not  being  equal  to  the  starting  location  of  the  trace. 

tJfreak  (at)  0 l23i:Q2,li5^’^^  (afttr  doing)  Xecutt 
tllfhfod9  /nstructlon  #;f#7gpe  fi>PC()IJ)^^ 
iff  1 1 ff^PC  <>  OI23i^^f^  <(han>  ffffffCo  (to) 
fffff'f' 

<Program  number  It  171  > ff 

Iho  difference  between  this  example  and  a single-stepped  trace  (using  the  .STEP 
breakpoint)  Is  that  here  any  called  routines  are  not  traced.  To  trace  the  loop  ri  times,  the 
continue  could  be  made  cone  onal  on  a counter  that  is  Incremented  whenever  the  starting 
location  is  reentered. 
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DETERMINE  WHICH  INSTRUCTIONS  WERE  NOT  EXECUTED 

An  interesting  use  of  the  PRIM  debugger  is  in  the  isolation  of  those  instructions 
within  some  region  which  were  nmwr  executed  while  running  some  program.  Ihis  can  be 
accomplished  by  setting  breakpoints  throughout  the  area  of  interest,  and  then  having  each 
execute-break  remove  its  own  breakpoint. 

#/7ebre.3lc  (from)  all  Iconl  Irml*^'* 

i/freak  (at)  0 1234:05670^^^  (after  doing)  Xecute 
f^/Jebreaic  (from)  #DPCD/Jl:*('/K^:^:i’00X>0:f::|:('/K--0/*’000X><>0C000Xrr 
iifGo  (to)  f'f 
gnt.r 

^Program  number  Is  (8]> 

#/ireak  (at)  05672^^^-  (altar  doing)  Xecuta 

#Co  (to)  0123^^ 

— > Braak  after  executing  856721  J 616068  fjiraak  (at) 

03457-04557  <X>(81  85672  <X>  i 

As  each  instruction  breaks,  Its  own  breakpoint  Is  cleared  by  the  Debreak  command.  /K  Is 
the  instruction  register,  containing  a copy  of  the  (first  word  of)  the  most  recent  instruction 
executed;  ptPCOLD  Is  the  address  of  that  Instruction.  The  long  expression  following 
evaluates  to  0 or  1 according  to  whether  the  instruction  is  short  or  long,  thus  clearing  the 
breakpoint  at  both  words  of  a long  Instruction  (the  second  term  Is  required  only  If  RL 
instructions  arc  used).  At  the  end  of  the  program,  a display  of  the  remaining  breakpoints 
shows  those  locations  that  were  never  executed. 


DETERMINE  WHEN  DATA  CHANCE  OVER  A CODE  SEQUENCE 

It  is  occasionally  necessary  to  determine  whether  a code  sequence  has  changed  the 
value  in  some  location.  Ihis  can  be  done  by  setting  a breakpoint  at  the  beginning  of  the 
sequence,  where  the  break-time  commands  copy  the  data  value  into  an  unused  location, 
and  setting  another  breakpoint  at  the  end  of  the  sequence,  where  the  break-time 
commands  compare  the  copied  value  with  the  current  value. 

In  the  following  example,  the  code  sequence  starts  at  0123^5  and  ends  at  023A56, 
the  critical  location  is  at  05^32,  and  0100  (assumed  here  to  be  unused)  Is  used  tor 
temporary  storage. 

Jf/lreak  (at)  012345^^^  (after  doing)  Xecute 
mSet  OlOO^^f'  = m5432^' 

HUGo  (to) 

<Program  number  Is  (91 > 

itireak  (at)  023456^*^  (after  doing)  Aecute 
fo05432^i^0100f^^c  <then>  fUGo  (to) 

n/fcr 

<Program  number  is  (10) > # 

liie  first  breakpoint,  at  the  entry  to  our  routine,  saves  a copy  of  the  contents  of  05A32; 
the  second  breakpoint,  at  its  exit,  compares  the  current  contents  with  that  saved  in  0100. 
tach  time  the  value  in  0b^32  changes  over  the  designated  code  sequence,  program 
execution  will  break.  Should  we  be  skeptical  about  the  availability  of  location  0100,  we 
could  establish  a breakpoint  there  which  would  break  on  any  reference. 
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SEARCH  A BtlEFER  FOR  A GfVFN  VALUE 

The  final  example  will  show  how  to  search  a buffer  (or  any  arbitrary  set  of 
locations)  for  the  occurrence  (or  non-occurrence)  of  a designated  value.  In  this  example, 
all  words  containing  4 in  the  left  half  are  located. 

#/.ocat«  (Mith  mask)  OFFOOX*^^^  (In) 

§ 

The  general  form  of  the  locate  command  requires  a comparison  value,  a mask,  and  a set  of 
addresses  to  examine.  The  comparison  value  and  mask  can  each  be  any  arbitrary 
expression.  Ihe  set  of  addresses  can  be  a list  of  discrete  locations  or  address  ranges. 
Dy  entering  NON  before  the  comparison  value,  the  test  is  inverted.  The  comparison  value 
defaults  to  "NON  0"  and  the  mask  defaults  to  "NOT  0"  (i.e.,  all  1 bits).  The  test  is  identical 
to  a masked  compare  (CM)  instruction  with  the  normal  form  being  a test  for  equality  and 
the  NON  form  a test  for  inequality.  Each  location  in  the  list  is  then  displayed  or  not 
according  to  whether  a match  or  non-match  was  specified.  The  locate  command  is 
analogous  to  the  type  command  In  that  if  it  is  terminated  by  an  exenpr  a replacement  value 
can  be  entered  for  each  displayed  location.  The  same  rules  for  the  replacement  value 
apply  for  locate-with-replacement  as  for  type-with-replacement. 
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APPENDIX!  UYK-aO  REFERENCE  LISTING 

DEBllCGER  NUIMERS  AND  OPERATORS 

The  debugger  evaluates  user  input  expressions  in  16  bit  twos  complement 
arithmetic  Identical  to  that  of  the  UYK-20.  The  operands  of  expressions  include  symbols, 
numbers,  and  character  constants:  the  operators  are  listed  below,  and  include  all  those 
found  in  the  ULIPA  assembler.  Expressions  may  be  parenthesized  to  an  arbitrary  depth. 

Input  numbers  may  be  octal  (leading  0),  decimal  (leading  non-0),  or  hexadecimal 
(loading  digit  and  trailing  X).  Output  is  identical,  except  that  when  hexadecimal  output  is 
requested,  a leading  A thru  F is  not  prefixed  with  a 0.  A character  constant  consists  of 
one  or  two  characters  included  in  single  quotes;  the  ASCII  character  set  Is  used,  allowing  8 
bits  per  character. 

The  integer  arithmetic  operators  are  +,  ♦,  /,  MOD,  and  ADS.  (MOD  is  the 
remainder  after  division,  while  ABS  is  a unary  operator  returning  the  absolute  value  of  the 
following  term.) 

The  relational  operators  are  <,  >,  <=,  >*",  and  <>.  Ihcir  value  is  1 when  the 
relationship  is  true  and  0 otherwise. 

The  Boolean  operators  are  44  (OR),  --  (XOR)  and  ♦♦  (AND). 

The  fetch  operator  is  tfi!).  fo  is  a unary  operator  whose  value  is  the  contents  of  the 
cell  addressed  by  the  next  term.  Is  invaluable  when  building  conditional  expressions  in 
break-time  programs.  It  also  provides  a good  shorthand  at  other  times,  e.g.,  "Kype) 
displays  the  next  instruction  to  be  executed 


UYK-aO  PARAMETERS  AND  DEVICES 

Various  UYK-20  options  are  selectable  as  parameters  of  the  emulated  UYK-20.  The 
settings  of  these  parameters  may  be  inspected  and  changed  by  the  user  at  any  time  via 
the  SEl  and  SHOW  commands. 

CLOCK  sets  the  clock  source  frequency,  expressed  in  ticks  per  second  (Hr).  The 
default  value  is  the  internal  source  frequency  of  1000  Hz. 

MEMORY  sets  the  size  of  memory,  expressed  in  8K  modules.  Ihe  default  is  a half 
memory  of  ^ modules. 

NDRO  selects  the  particular  NDRO  program,  by  name.  The  selections  available  are 
listed  in  response  to  the  Set  subcommand  NDHO  F.  The  default  is  the  Standard 
NDRO. 

REGISTER-SETS  controls  the  installation  of  the  optional  register  set  The  parameter 
value  Is  either  one  or  two  sets;  the  default  is  one.  When  only  one  set  is  installed, 
the  general-register-set  selector  bit  in  status  register  «1  is  ignored. 
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Devices  are  installed  on  UYK-20  channels  via  the  INST  At  I command.  Installation  of 
a device  Implies  the  simultaneous  installation  of  the  appropriate  type  of  channel. 
Therefore  the  user  need  never  be  concerned  with  the  installation  of  channels. 
Furthermore,  all  channels  arc  available  for  the  installation  of  any  type  of  device,  without 
restrictions  concerning  channel  groups;  also,  32-bit  channels  do  not  require  the  use  of  a 
second  channel  (at  n+1  or  n-*^)  to  carry  half  thj  data.  It  Is  therefore  possible,  though  not 
ncccosarlly  useful,  to  specify  configurations  which  cannot  be  built  on  an  actual  UYK-20. 
The  list  of  Implemented  devices  that  may  be  Installed  Is  listed  In  response  to  the  command 
INST/liL  y. 

One  optional  parameter  which  Is  specifiable  for  every  installed  device  Is  the  device 
speed,  expressed  in  some  units  appropriate  to  the  device  (characters  per  second,  cards 
per  minute,  inches  per  second,  ...).  The  default  Is  either  the  actual  speed  or  a typical 
speed  of  that  device.  Altering  the  parameter  linearly  alters  all  the  timing  associated  with 
that  device. 

Temporary  speed  increases  can  be  useful  in  speeding  up  lengthy  processes  for 
which  timing  is  not  critical.  The  principal  example  Is  a bootstrap  load;  a factor  of  two  or 
four  increase  In  the  emulated  speed  of  the  bootstrap  device  results  in  a substantially 
faster  bootstrap.  Speed  changes  may  also  be  used  to  experiment  with  the  effect  of 
variations  in  data  rate  on  program  performance  or  throughtput. 

For  the  device  7TY-lb32  (the  TIY  on  the  1532  operator  console),  interrupt 
transmission  of  the  next  character  Is  indicated  by  entering  the  two-character  sequence 
rottirol-xhift  0,  where  roniroi-Mhifi  Is  the  PRIM  control-shift  input  control  code  (not 
tfie  control-shift  key  on  the  terminal.) 


UYK-20  SYMBOLS  AND  CELLS 

In  addition  to  memory,  the  following  cells  are  Known  to  the  debugger  and  are 
accessible  by  the  indicated  names.  Except  as  indicated,  modification  of  any  cell  affects 
future  behavior  of  the  UYK-20  in  the  obvious  manner.  For  example,  changing  the  state  of 
an  I/O  chain  from  idle  to  chaining  will  cause  that  chain  to  resume  execution  (at  its  chain 
address  pointer  location)  when  execution  is  next  resumed.  The  only  note  of  caution 
concerns  the  device-to-channel  bits  In  the  I/O  interface;  they  may  not  be  altered  with 
confidence  since  they  are  inextricably  tied  to  (inaccessible)  device  status  Information. 

I\0  thru  HIT*  (decimal):  the  primary  register  set. 

RKO  thru  KRiTt  (decimal):  the  secondary  register  set. 

PG.O  thru  PG.77  (octal):  the  page  registers. 

N.O  thru  /V.77,  N.300  thru  N.i77  (octal):  NDRO  memory.  Any  attempt  to  store  into 

NURO  generates  a break,  and  the  write  is  ignored. 


TKfC.O  thru  TK!GJ7  (octal):  The  trigonometric  CORDIC  constants. 
IfYPKK.O  thru  IIYPER.H  (octal):  The  hyperbolic  CORDIC  constants. 
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The  (ollowinp,  are  one  b,t  colls  which  correspond  to  control  panel  swdehos  and  clock 
enable  functions. 


MCI  IVIK  aiilo-slarl  switch.  When  set  by  the  user,  causes  the  UYK-20  to  execute 
n.aslef  clca^oquence  and  then  begin  executing.  MCLFAR  is  always  cleared  by 
,ho  emulator  at  the  end  of  the  master  clear  the 

reset  of  all  the  emulated  devices  as  well  as  the  regular  CPU  and  IOC  reset. 


lO/in  load  switch  Causes  the  UYK-20  to  execute  a master  clear 

the  PC  to  2.  and  begin  executing.  LOAD  Is  cleared  by  the  emulator  at  the  en 

llio  macLicr  clear. 


imm:  noolstrap  1/2  selector.  Set  Is  bootstrap  2;  clear  is  bootstrap  1.  Never 
modified  by  the  emulator. 


swri,  STOI'2-.  Set  is  ON;  clear  is  OFF.  Never  modified  by  the  emulator. 

KTCE:  Real  lime  clock  enable,  allows  the  clock  to  be  advanced  at  each  tick 
interval. 

MCKf>.  Monitor  clock  enable,  allows  the  clock  lo  be  decremented  at  each  tick 
interval. 

HTCIFr.  Real  time  clock  Interrupt  enable,  allows  the  real  time  clock  overflo 
interrupt  request  to  be  p,enerated. 


The  following  are  the  miscellaneous  other  registers  accessible  <u  the  user. 

rC:  the  current  program  counter  (containing  address  of  the  next  instruction). 


SHI,  SH2:  the  status  registers. 

HTCU,  HTCI>:  the  real  time  clock,  upper  and  lower. 


MCH\  monitor  clock  register. 

is  used  lor  each  channel,  with  bit  0 for  channel  0 and  bd  lb  for  channel  lb. 


INT1.21  pending  class  I and  II  interrupts. 

Ettt  15*  Power  fault  (never  generated  internally). 

n,|  l/l:  Memory  resume.  (Generated  internally  only  when  a 

reference  is  made  lo  nonexistent  memory.) 

Hit  13-8:  Class  I,  priority  3 thru  8. 

Hit  7:  CP  Instruction  fault. 

Hit  6:  IOC  Instruction  fault. 

Hit  5:  Floating  point  overflow/underflow. 

Flit  Executive  return. 

Hit  3:  RIC  overflow. 
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pit  ?:  Monitor  clock  ovcUlow. 

{tits  1*0:  Class  II,  priority  7 thru  8. 

INT.flC:  Class  III  intercomputer  timeout  interrupts  pending. 

INT.IX:  Class  III  external  interrupts  pending.  (Ihis  bit  is  set  at  the  time  that  the 
status  word  Is  stored  in  memory.) 

INT30:  Class  III  output  chain  Interrupts  pending. 

INT3I:  Class  III  input  chain  interrupts  pending. 

F.IIC:  Channel  external  interrupt  enable  flags. 

CIIIK:  Channel  Interrupt  enable  flags. 

The  next  five  items  are  merely  informative;  altering  them  does  not  affect  the  future 
behavior  of  the  UYK-?0. 

IK:  Ifistruction  register  containing  the  last  instruction  executed  (the  first  word  for 
a long  instruction). 

A’/J:  Effective  address  of  the  instruction  in  IR.  For  RK,  It  is  the  effective  constant. 
(Displaying  IR  in  instruction  mode  will  display  both  IR  and  EA  for  long  instructions.) 

C/IK:  Channel  address  pointer,  indicating  the  type  of  the  last  instruction  cycle 
executed.  7ero  Indicates  CF^U  (DPS)  execution;  a value  of  8n+2  indicates  IOC 
execution  by  the  input  chain  on  channel  n;  a value  of  Sn^G  indicates  the  output 
chain  on  channel  n. 

M /IK:  Memory  address  register,  giving  the  last  relative  memory  location 
referenced.  If  the  last  reference  was  an  instruction  fetch,  MAR  addresses  the 
location  following  the  instruction.  MAR  is  set  by  ctiannel  transfer  cycles  and 
interrupt  cycler,  as  well  as  by  execution  cycles. 

VCOl.lh  the  program  counter  at  the  start  of  the  last  CPU  instruction  cycle. 

The  remaining  items  are  all  concerned  with  the  UYK-20  channels  and  channel-device 
interfaces.  Hexadecimal  notation  is  used  to  designate  the  channel  number  with  a single 
digit  of  0 thru  F. 

CM.O  thru  CM.FF  (hexadecimal);  channel  control  memory.  The  two-digit  number 
designates  the  channel  in  the  first  digit  and  the  word-within-channet  in  the  second 
digit. 

ICII.O  thru  ICII.F:  the  Input  ciiain  state  for  each  channel. 

(K'.II.O  thru  OCII.F:  the  output  chain  state  for  each  channel.  For  both  input  and 
output  chains,  the  state  values  are; 


0:  Idle. 

1:  Chaining. 
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?;  Search  for  first  sync  (synchronous  communication  channel  only). 
3:  Search  for  second  sync. 

Input  data  transfer, 
b:  Output  data  transfer. 

6:  Function  transfer  (parallel  and  NIDS  channel  only). 

7:  Forced  function  transfer  (parallel  and  N1D3  channel  only). 


All  channebdevice  data  transfers  take  place  identically  In  the  emulator,  regardless  of  the 
actual  channel  type.  Transfers  occur  one  byte  (8,  16,  or  32  bits)  at  a time,  following  the 
model  defined  for  a parallel  I/O  channel,  but  with  a buffer  to  hold  each  dr,*.um  In  turn. 
F ach  transfer  uses  the  appropriate  buffer  for  the  channel  and  two  Interface  bits,  a 

request  bit  and  an  acknowledge  bit.  For  parallel  and  NIDS  serial  channels,  functions  are 
transferred  the  same  way,  while  status  uses  EIE  and  EIFE 


Ili.O  thru  lll.h':  the  Input  (device  to  channel)  buffers. 
OH.O  thru  Oli.F:  the  output  (channel  to  device)  buffers. 


inii.O  thru  IDH.F: 
inn.O  thru  in/].F: 
OnF.n  thru  Onii.F: 
on/l.n  thru  OnAF: 
FFR.n  thru  F.FR.F: 
KFA.O  thru  F.F/\.F'. 
Fin.O  thru  FIR.F: 


input  data  request  (device  to  channel)  flag. 

Input  data  acknowledge  (channel  to  device)  flag. 

Oufput  data  request  (device  to  channel)  flag. 

Output  data  acknowledge  (channel  to  device)  flag. 
Function  request  flag  (parallel  and  NTDS  serial). 

Function  acknowledge  flag  (parallel  and  NIDS  serial). 
External  interrupt  request  flag  (parallel  and  NUTS  serial). 


The  static  lines  for  communication  channels  are  given  their  MIL-SlD-188  names  (A  thru  L); 
A,  D,  F,  G,  II,  and  J arc  the  outbound  linos,  while  B,  C,  E,  I,  K,  and  L are  the  inbound  lines. 
These  flags  are  not  valid  for  parallel  or  NTDS  serial  channels.  The  eight  RS-232C  control 
lines  are  mapped  Into  these  lines  as  noted  in  the  list  below;  the  mapping  is  taken  from  the 
channel  cable  pin  assignments. 


l()/],0  thru  IO/].F: 
1011.0  thru  lOR.F: 
lOC.O  thru  lOC.F: 
IOI).0  thru  lOn.Fi 
IOF.O  thru  lOF.F: 
0)1. 0 thru  lOF.F: 
lOa.O  thru  lOG.Fi 
0)11.0  thru  0)0.F: 
0)1.0  thru  0)I.F: 
0)J.O  thru  lOJ.F: 
IOK.O  thru  0)K.F: 
IOF.O  thru  0)I..F: 


Loop  test. 

Ring  indicator  (CF). 
Carrier  detect  (CF). 

Data  terminal  ready  (CD). 
Clear  to  send  (CB). 

Now  sync. 

F^cquest  to  send  (CA). 


Data  set  ready  (CC). 


BREAK  POFNTS 

The  UYK-20  emulator  Is  continually  monitoring  the  execution  of  the  UYK-20  to 
detect  the  occurrence  of  any  break  conditions  which  may  be  set,  (Breaks  are  neither  set 
nor  cleared  by  the  emulator;  only  the  user,  via  the  debugger  breakpoint  commands,  can  set 
or  clear  breaks,)  When  a break  condition  is  detected,  the  break  occurs  after  the  event,  at 
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the  end  of  the  current  cycle  of  execution.  It  Is  thcioforc  possible  for  multiple  breaks  to 
bo  reported  at  one  time.  Each  UYK-20  cycle  consists  of  the  execution  of  one  of  the 
following  items: 

1.  A CPU  instruction,  including  indirect  addressing  (for  the  KXP  or  RLX  instruction, 
execution  of  the  \0C  command  or  remote  instruction  takes  place  in  the  same  cycle). 

2.  An  iOC  chain  instruction. 

3.  A CPU  interrupt  sequence  duo  to  a pending  interrupt  request.  1his  cycle  includes 
the  storing  of  PC,  status  and  clock,  and  the  fetching  of  new  PC  and  status.  The 
creation  of  a pending  interrupt  is  a side  effect  of  a previous  cycle  (or  a manual 
operation  by  the  user). 

A single  channel  data  transfer  under  control  of  a buffer  control  word. 

b.  A clock  cycle,  which  occurs  at  each  clock  tick  interval  whether  or  not  the  real-time 
and  monitor  clocks  are  enabled. 

6.  A device  execution  cycle. 

7.  An  external  interrupt  cycle.  In  which  a channel  stores  a status  word  and  generates 
an  external  inirrrupt  request. 

There  is  an  event  associated  with  each  of  the  first  five  types  of  cycles,  allowing  the 
user  to  break  execution  after  any  cycle  of  the  given  type.  Devices  cannot  be  directly 
monitored;  one  must  monitor  the  channels  Instead.  The  external  interrupt  cycle  can  be 
monitored  via  a write  break  set  at  any  or  all  of  the  El  Storage  locations  in  memory. 

The  following  event  flags  arc  defined  for  the  UYK-20: 

.STI'T:  Hrcak  after  any  CPU  execution  cycle. 

.Cn/]IN:  Break  after  any  chain  or  command  execution. 

.INT:  Efrcak  after  any  interrupt  cyclo. 

Break  after  any  ICX^  transfer  cycle. 

.TICK:  Break  after  any  clock  tick  interval. 

.JUhU*:  Break  after  any  transfer  of  CPU  control  to  other  than  the  next  instruction. 
Includes  interrupts  as  well  as  (successful)  conditional  jumps,  but  does  not  Include 
NOP  (IJfia). 

.STOhK:  fJreak  after  any  memory  store,  including  those  generated  by  I/O  and 
interrupts. 

.NJMPi  Break  after  any  CPU  conditional  jump  instruction  which  doesn’t  jump. 


./INOhh  Break  after  any  of  a number  of  switchable  anomalies,  including: 


UYK-20  User  Guide 
Appendix:  Breakpoints 


Page  21 


Illegal  Instruction.  An  illegal  CPU  or  IOC  instruction  is  executed.  The 
instruction  has  set  an  interrupt  request  in  INTI,2,  which  will  cause  an 
interrupt  when  execution  next  resumes  - unless  it  is  cleared. 

External  interrupt  while  not  enabled.  A device  (on  a parallel  channel) 
generated  an  external  Interrupt  request  when  EIE  was  not  set  on  that  channel. 

Improper  Indirect  Address  Word.  The  J value  is  one  of  the  unassigned  values. 

An  10  transfer  specifying  EF  or  EPF  is  executed  on  a communications  type  (not 
NTDS)  serial  channel  (the  EF/EFF  Is  turned  into  a NOP). 

A communications  charmel  operation  (such  as  CSIR  or  CSST)  is  executed  on  a 
parallel  channel  (the  operation  is  turned  into  a NOP). 

In  addition,  the  following  anomalies  always  generate  a break,  regardless  of  the  setting  of 
.ANOM: 

Device  error.  Usually  occurs  when  an  unconfigured  channel  executes  an  EFF. 

Odd  memory  address  (in  a double  word  reference).  The  addressed  word  has 
been  used  twice. 

Odd  register  number  (in  a double  register  reference).  The  addressed  register 
has  been  used  twice. 

Store  into  NDRO.  The  store  is  not  performed. 

In  addition  to  the  above  events,  breaks  can  be  set  at  specific  locations,  to  occur  only 
when  the  location  is  referenced  in  the  indicated  manner.  The  three  forms  of  reference 
are: 

X:  Execute  includes  the  fetch  of  a short  instruction,  or  the  fetch  of  the  first  word 
of  a long  instruction.  Applies  to  CPU  and  IOC  execution  equally. 

R:  Read  includes  any  other  fetch.  (Neither  break  includes  the  second  word  of  a 
long  instruction.) 

W:  Write  includes  any  store  into  the  given  cell  for  any  reason. 

These  reference  breaks  may  be  applied  to  the  following  cells: 

Memory:  all  three  forms,  in  any  combination,  by  absolute  (not  relative)  address. 
NDRO:  Read  and  Execute  breaks. 

Registers:  Write  break,  in  each  set  separately. 

Channel  control  memory:  Write  break,  on  each  pair  of  words.  (A  brecK  applies  to 
both  words  of  an  even-odd  pair  regardless  of  the  cell  actually  specified.)  A break  on 
a channel  address  pointer  can  be  used  to  single  step  a particular  chain,  while  a 
break  on  a buffer  control  word  can  be  used  to  single  step  a particular  transfer. 
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Inp'.  .16  Output  (Interface)  Buffers:  Write  brocK,  for  each  separately.  The  break 
is  ali«vays  takers  after  the  cycle  which  wrote  the  word,  but  before  the  cycle  which 
will  read  - word.  Therefore,  any  alteration  of  the  data  is  effective.  The  break 
on  the  Inpui  buffer  Is  the  only  break  triggered  by  a device  cycle  (other  than  a 
device  error  anomaly). 


PRIM  SYSTEM:  USER  REFERENCE  MANUAL 


INTRODUCTION 

This  document  is  the  common  reference  manual  for  all  users  of  the  f’hlM  r.ystf'm, 
both  those  using  one  of  the  existing  emulation  toois  and  those  writing  new  emulators,  f or 
tho  former,  this  manual  is  supplemented  by  the  appropriate  tool-specific  guide  (r.p., 
System:  UlOSO  User  GtUde)i  for  the  emulator  writer,  the  supplement  is  f'KIM  System:  loot 
Ihiildcr  ManuaL 

1 hc'  PIdM  system  is  always  in  one  of  throe  states,  Known  a',  the  evec,  the  dr'l)iig,ger, 
and  the  target  execution  states,  the  transition  between  states  is  controlled  by  ttie  user. 
[K)th  of  the  first  two  states  are  PRIlvl  command  processors  that  tal.o  commands  frcjm  the 
u-  er  and  execute  them.  Ihc  exec,  whose  command  prompt  ciiaraciei  is  is  iist.cl 
(irincipally  for  setting  up  a target  environment;  the  debugger,  whose  command  prompt  is 
'V,  is  used  for  the  detailed  examination  and  control  of  thr  executing,  target 
machine.  7arget  execution  includes  the  emulation  c'  not  only  the  CPU,  but  also  clocks  and 
assorted  peripheral  10  devices.  I he  three  sections  following  the  introduction  describe 
e ach  of  the  states  in  turn. 

Iho  PRIM  exec  and  debugger  commands  are  illusl  sd  with  examples  taken  from 
actual  session  transcripts.  In  all  the  examples,  us.jr  input  is  iinlitized  to  distinguish  it 
from  PIdM  output.  Input  control  characters  appear  as  their  abbreviations  superscripted 

GENERAL  INPUT  CONVENTIONS 

User  input  to  f’RIM,  both  exec  and  debugger,  is  generally  free- format  and 
case-independent,  leading  spaces  and  tabs  are  ignored,  and  lower  case  is  treated  as  its 
U()pcr  case  equivalent  (except  in  quoted  strings,  where  case  is  potentially  significant ). 
User  input  to  tho  target  machine  during  target  execution  state  is  in  thr  format  required  by 
the  target  system. 

Certain  characters  have  been  assigned  editing  and  intervention  function',  wticn  input 
by  the  user.  I he  editing  characters  apply  only  to  the  PRIM  exec  and  drhugger,  while  the 
intervention  characters  apply  to  the  target  execution  state  as  well.  The  specific 
characters  assigned  to  most  of  the  functions  may  be  altered  (via  ttie  exec  Change 
command)  to  suit  one’s  needs.  The  editing  functions  arc  valid  at  any  time  during  PRIM 
command  input;  commands  are  not  executed  until  after  the  final  character  has  been 
accepted. 

Itnck-Mfificc  (cntl-H)  erases  a character  from  the  current  word  or  term  of  input.  Ihc 
back-space  is  echoed  as  a backslash  (\)  followed  by  the  erased  character.  When 
there  are  no  erasable  ch  iracters,  a bell  (cntl-G)  is  echoed  instead. 


/ilternnte  bnek-spnee  (initially  cntl-A)  performs  a function  identical  to  hnrk-Kpnee',  it  is 
provided  as  a convenience. 
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itnrktif)  (initially  cntl-W)  erases  the  current  word  or  term  of  irifuit.  It  is  echoect  as 
hacKslash  (\)  followed  by  the  first  character  of  the  erased  word. 

Ketypo  (initially  cntl-R)  retypes  tfie  current  input  line;  it  is  useful  after  a confusinp, 
amount  of  cdilinp  has  occurred. 

Delete  (initially  DEL  or  f^UBOUl ) aborts  the  current  input  command  or  subcommand, 
allowinp  the  user  to  re-enter  it.  It  is  echoed  as  " XXX". 

(Jiiesiinn  (?),  when  entered  at  the  beginning  of  a cor.nand  field,  elicits  a description  of 
the  expected  input,  followed  by  a retype  of  the  line.  When  the  expected  input  is  a 
selection  from  a list  (or  menu),  the  entire  list  is  shown. 

The  intervention  characters  are  valid  at  any  time,  including  command  input,  command 
interpretation,  and  target  execution. 

Ahort  (initially  cntl-X)  interrupts  the  current  activity  and  returns  control  to  the 
command  level  of  either  exec  or  debugger.  When  used  to  cancel  an  exec  or  debugger 
command,  control  returns  to  the  top  level  of  the  same  state;  abort  is  the  only  means  of 
canceling  a command  when  the  user  is  in  subcommand  mode.  When  used  to  interrupt 
target  execution,  control  returns  to  the  state  from  which  execution  was  initiated;  abort 
is  the  only  means  of  stopping  a looping  target  machine. 

i>ioins  (initially  cntl-S)  produces  a one-line  summary  of  target  machine  status,  including 
program  counter,  emulated  elapsed  time,  and  active  ID  devices.  The  command  is  valid 
at  any  time,  but  useful  primarily  in  execution  state. 

The  following  character  is  active  only  during  target  execution. 

C.onirol- shift  (initially  cntl-1)  permits  the  user  to  enter  (during  execution)  a control 
code  that  cannot  be  entered  diiectly  because  it  is  interceptt  d by  either  RRIM  or  the 
operating  system;  the  EMdM  characters  inolved  are  status,  nhnri,  and  enntrol-shift  itself, 
ffie  next  ASCII  character  following  the  control- shift  (other  than  the  digits  0 tfiru  9)  tias 
its  two  leading  bits  cleared,  thus  converting  it  to  an  ASCII  control  code  (/I  or  n to 
riitl-A,  etc.).  Control-shift  followed  by  a digit  results  in  an  input  that  is  outside 
the  normal  target  character  set  and  is  used  for  particular  tar  get -machine-depencient 
functions.  The  control-shift  character  itself  is  not  echoed,  and  not  passed  to  the 
target  machine.  If  execution  terminates  before  that  next  character  is  input  to  the 
target  device,  the  control-shift  is  canceled;  it  is  not  retained  for  the  next  resumption  of 
execution. 
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PRIM  EXEC 

Ihe  PRIM  exec  is  the  initial  state  of  a PRIM  session.  Lxcc  commands  are  concerned 
primarily  with  building  target  configurations,  saving  f^RIM  session  results,  restoring 
previously  saved  sessions,  and  accessing  or  creating  files  (within  the  file  space  of  the  host 
operating  system). 

The  exec  prompt  character  is  indicating  that  PI^IM  is  in  exec  state  and  that  tlie 
exec  is  awaiting  a new  command;  it  is  always  shown  on  a new  line.  Individual  input  fields 
consist  of  keywords  (a  v/ord  selected  from  a menu),  decimal  numbers,  and  file  names. 
I xec  commands  are  composed  of  fixed  sequences  of  fields,  each  terminated  by  a delimiter 
character;  a final  confirmation  consisting  of  a rrturn  is  often  required. 

Keywords  are  selected  by  any  unambiguous  leading  substring.  01  ten,  a single 
character  suffices;  three  characters  are  always  sufficient.  Numbers  are  specified  in  tlieir 
entirety.  MIc  names  are  specified  accordirig  to  the  conventions  of  the  operating  system. 
All  commands  that  will  use  a file  for  output  require  the  name  of  a new  file  (except  the 
Mount -Append  and  Mount-Old  commands,  which  modify  existing  files);  all  oltier  file 
commands  require  the  name  of  an  existing  file.  In  ItNfX,  an  existing  file  name  - and  a 
new  file  tfiat  is  a new  version  of  an  existing  file  name  * - is  recognized  (and  completed)  in 
response  to  an  input  i^arnpr. 

Itic  normal  delimiters  that  terminate  command  fields  are  rctvnt,  rs.cnpr,  and  .s/mrr. 
llscnpc  and  xpnrr  function  identically  except  that  the  former  generates  feedback  to  the 
user  while  the  latter  generates  none;  the  feedback  produced  by  esrnpr  includes  both  field 
completion  and  next-field  prompting  (which  is  given  in  parentheses).  Hrhirn  is  used  to 
complete  a command  immediately,  bypassing  any  remaining  fields  and  confirmation;  if 
furtfier  input  is  required,  the  return  is  treated  as  an  rsrfipo.  (In  the  examples  that  follow, 
rsrnpc  termii.ation  is  used  to  show  the  prompts.) 

Keywords  that  involve  either  devices  or  parameters  are  machine-dependent;  the 
selections  shown  in  the  examples  are  meant  to  be  illuslralivc  rather  than  clrfinitive. 
Uc'vice  specification  is  further  complicated  when  two  (or  more)  of  the  same  generic  devir  o 
me  installed.  Ihc  refore,  for  device  names,  two  further  delimiters  arc  utilized,  nf  ("('•^")  and 
colon  (";").  A fully  qualified  device  name  consists  of  ^rnrn'r-iwntr  fio  rhnnnrt-  nttnthrr  : 
nnii-nnmltrr;  the  numbers  are  required  only  to  the  extent  necessary  to  sf)ecify  a 
particular  device.  When  a device  name  is  terminated  by  one  of  the  standard  terminators, 
and  when  further  disambiguation  is  required,  the  exec  prompts  explicitly  regardless  of  the 
tr  rminator. 

7 lie  reraainder  of  this  section  consists  of  the  descriptions  of  the  exec  commands  in 
alfiliabclical  order,  bach  command  description  begins  with  a transcript  showing  one  or 
more  examples  of  the  command  and  its  various  options.  7 hose  commands  that  require  a 
se  cond  keyword  show  that  list  via  an  input  question.  7 he  exec  commands  arc: 


•fr  ii'Vriri  ir  •• 
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>y  One  of  (ho  foiloMingi 
CONCEL 
CUnNGF 
CLOSE 

coonnNos 

Of  DUG 

FllESTOTUS 

GO 

INSTOLI 

nOUNT 

NEUS 

PERIPflEROlS 

QUIT 

RrnssiGN 
Rl STORE 
REWIND 
snvE 
Sf  T 
SHOW 
SYMBOLS 
TIME 

TRONSCRIPT 

UNINSTRLL 

UNMOUNT 


Comment. 

>;  this  line,  in  n commriu^'' 

> 

Any  line  bepinninp  with  a nomirolon  is  treated  as  a comment.  Comments  are  recorded  in 
the  transcript  if  one  is  open  (see  Iranscript  command). 

CancH  abandons  all  outstanding  10  operations  for  a designated  device. 

>rfj<'’^^NCFL  <10  lor  device)  lo^^^PE-UNIT 
> 

This  command  is  intended  for  use  when,  after  an  10  error  halt  (described  in  the  section  on 
target  execution),  the  user  wishes  to  abandon  the  device  operation  rather  than  mount  a 
file  and  retry  the  operation.  The  list  of  outstanding  10  operations,  by  device,  is  part  of 
the  Peripherals  command  output. 


— iBirr'i  Tr"'i -j 
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Change  reassigns  the  PRIM  control  functions. 

>^/,e.«rnNGF  (Input  coda  lor)  ^ On®  of  the  lolloMingi 

nnoRT 

nn-Rnc^'SPRCE 
Bnri.up 
ni  LEU 
RETYPE 
sin^"S 

CONTROL-SHIFT 

>CHnNGE  (Input  code  for)  ab^^^ORJ  (from  tX  to)  ? fl  Control  Code. 

>CHnNnF  (input  code  lor)  RBORT  (Irom  tX  to)  ^ 

>r/i^'^RNGE  (Input  code  lor)  rf^^^ELETE  (Irom  <DEL>  to;  Inot  ch.inqndl 
> 

This  commancJ  allows  the  user  to  change  the  ASCII  control  code  assigned  to  any  of  the 
listed  PRIM  control  functions  from  its  current  assignment  to  another  (currently  unassigned) 
control  character.  The  function  name  is  the  second  word  of  the  command;  when  it  is 
terminated  with  an  o/^rapo,  the  current  assignment  is  noted  in  the  noise.  The  entire  set  of 
ASCII  control  codes  (including  delete)  is  available  excepting  nr;//,  hnrk-f^pne.e,  line- feed, 
return,  esr.npe,  and  unit-Keparntor  (ItNEX  end-of-line)  which  have  fixed  functions  in 
PRIM.  For  nlwrt  and  xintux  the  set  is  limited  to  cntl-/)  thru  r.nil-/. 

Close  terminates  the  current  transcript  file  if  one  is  open. 

>p/r.<ro5f  (transcript  I Mo.) 

> 

A transcript  file  is  opened  using  the  Transcript  command;  it  is  automatically  closed  at  the 
end  of  a session. 

Commands  redirects  subsequent  input  from  a file. 

>PoO.<rniinNns  (irom  mIp)  commnndjile^^^'  " 

> 

This  command  causes  F’RIM  to  read  its  subsequent  command  input  from  the  named  file 
instead  of  the  user  terminal  (or  current  command  file).  The  file  input  is  treated  exactly  as 
terminal  input  except  that  intervention  functions  {nhnrt  and  status)  are  valid  only  from  tho 
terminal.  Should  a command  in  the  file  cause  execution  to  be  resumed,  input  that  normally 
would  come  from  the  user  terminal  is  taken  instead  from  the  file.  Input  reverts  to  the 
previous  source  at  the  end  of  the  file;  an  abort  terminates  all  command  files  and  reverts 
input  to  the  user  terminal.  Command  files  may  be  nested.  Co;  , H files  are  very  useful 
for  common  session- initialization  sequences. 

Dc^bil^i  transfers  control  to  tho  PRIM  debugger. 

>r/»-'^LPUG 
iyirturn  (to  EXEC) 

> 

The  PRIM  debugger  is  described  in  the  next  section;  control  is  returned  to  thi  ec  via  the 
debug  Return  contmand. 
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Hlrstatus  returns  information  about  mounted  files  for  all  or  dcsiRnatecI  devices. 


>y’r.<riips]nUJS  (for  drvlce)  RLI. 
Rjicord  Flit)  Niiine  Dnvice 


J? 

1? 

8?5 

24C 


cnKD.nr  ci: 

U'.fr  Tly 
11  RIIINnt  . INPUT 
mm.  OUT 
nnro.EFC 


CORO-RtfiOER 
PRINTER 
TLRniNni  (In) 
mmiNni  (Out) 
TflPE-UNITi0 


>/^-'^II  rsimus  (for  dev  ce)  rn^^^RD-REROER 
Record  Tgpe  Pgle/Ltist  File  Name 

12  ninl?  960/1280  CRRO.OECK 

> 

When  the  device  field  is  empty  {return  or  e.urnpc)  all  mounted  files  are  listedj  otherwise 
just  the  filc(s)  on  the  named  device  are  listed.  Ihe  latter  case  gives  more  complete  status 
than  docs  the  former.  Ihe  output  fields  are: 


Record  tells  Ihe  current  position  of  the  device  or  the  number  of  records  which  have 
been  processed,  for  disks,  It  is  a sector  number;  for  card  readers  and  punches,  a 
card  count;  for  communication  lines,  the  total  number  of  bytes  transferred;  for  mag 
tape  units,  the  position  from  beginning  of  tape  expressed  as  files  records. 


nic  Name  is  the  name  of  the  file;  the  name  "User  Tty”  is  displayed  when 
THIS  ri'MSflNAI.  is  the  file. 


Device  is  the  emulated  device  on  which  the  file  is  mounted. 

Type^  describes  the  type  of  file,  either  Ascii  or  [linxx,  where  xx  is  the  file  byte  size. 
The  type  may  have  been  explicitly  specified  at  mount  time,  or  it  may  have  been 
assumed  by  PRIM. 

[fyte/Last  is,  for  a mounted  disk  file,  the  current  byte  position  in  the  file  and  the  total 
number  of  bytes  in  the  file. 

The  marginal  notation  ’’[not  opened]"  indicates  that  the  named  file  could  not  be  found  (this 
occurs  only  to  a restored  file)  and  that  the  device  must  be  reassigned  to  another  file  (or 
to  the  same  file  via  a new  path  name). 

Go  transfers  control  to  the  target  execution  state. 

(from  1234) 

~ > nnCUlNt  running  at  6670,  Usod  0iOO.4 
- > nnr.HINE  halted  at  6943,  Used  6tO1.0 
> 

This  command  transfers  control  from  the  PRIM  exec  to  the  emulator  or  target  machine,  in 
its  current  state.  Control  returns  to  the  exec  when  the  target  machine  halts  or  a 
breakpoint  is  encountered  (see  the  debugger  Break  command)  or  the  user  interrupts 
execution  with  an  abort. 


In  the  example,  the  user  followed  the  command  with  a nintu$  request  (the  character 

itself  is  not  echoed)  resulting  in  the  first  reply  line  (MACHINE  running  at  ...);  the  target 
machine  is  still  running.  Eventually  the  target  machine  halted,  producing  the  second  status 
lino  and  returning  control  to  the  exec  as  evidenced  by  the  exec  prompt. 
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Install  adds  a dc5ip,natcd  type  of  device  to  the  machine  configuration. 

I (rlnv!c«)  ? One  of  the  following: 

CORO-RtnOER 

PRINTER 

TOPE-CONIROII ER 
TERniNOL 

>INSinLl  (dnvirn)  p^-'^RINiER  (CHONNEL) 

»?  SPIED 

(ch.iraclere  per  second)  ^*^308 

>><’» 

>i'’'^‘NST0Ll  (device)  In^’^^PE-CONTROLLE.'T  (CHRNNEL)  3^’^ 

How  many  TMPE -UNIT’S  do  you  want?  2^^ 

For  the  first  TOPE-UNIT,  (UNIT)  0^'^ 

for  tho  sneond  TOPE-UNIT,  (UNIT) 

>><’» 

> 

Ihc  device  type  is  selected  from  among  those  implemented.  !he  user  is  prompted  for 
each  necessary  item  of  information,  typically  including  an  address  for  the  device  in  the 
target  10  address  space  and  the  rrumber  of  units  to  install.  After  the  required  information 
is  gathered,  sub  command  mode  (*'»"  prompt)  is  entered  to  gather  optional  parameters; 
any  optional  parameter  not  supplied  takes  on  its  default  value.  Subcommands  are 
terminated  by  an  empty  command,  rriurfi  only.  An  installed  device  is  initially  unmounted 
--  there  is  no  file  associated  with  the  device  for  purposes  of  actual  10. 

When  the  device  being  installed  is  a multi-unit  controller,  the  dialogue  proceeds  through 
each  of  the  individual  units  to  gather  their  parameters.  After  the  command  is  completed, 
the  controller  is  no  longer  visible;  only  the  individual  units  are.  An  nhori  aborts  the  entire 
command,  not  just  the  current  unit. 

Installation  is  permitted  only,  before  any  execution  has  taken  place.  Typically,  a user  or 
user  group  installs  a standard  configuration  and  then  saves  it  for  urc  in  all  subsequent 
sessions  (sec  the  Save-Configuration  and  Restore  commands).  The  optional  parameters  of 
an  installed  device  may  be  changed  at  any  time  using  the  Set  command. 


irVw-iiiiiWTaiB 
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Mount  associates  a file  with  an  installed  device. 


>rM»-*»-0UNT  (0,1,N,OL,OU,T,?)  ? 0n«  of  Iho  folloMlng: 
nPPEND 
INPUT 
NIU 

01  n 

OUTPUT 

THlS-TERfllNni 

>nOllNl  (0, 1,N,0L,0U,1,?)  l^*^HIS-TCRri!N0L  (on  device)  /)^^^RlNTtR 


>me.<roUNT  (R,  I ,N,0L,0U,T,  ?)  (In  « out  file)  /)ltCI).KFC;l^^^  (on  dtvlce) 

lo^^^PE-UNIT  " 


> 


>rfi  i^’^^'NPUT  (from  file)  cnrd.deck^*^  (on  device)  rn^^^RO-REROER 

»?  BINRRY  or  RSCII 

»/)^-'^INRRY  (with  byte  sl7e)  12^^ 

»rr 

> 

Associating  a file  with  an  installed  device  causes  subsequent  emulated  10  for  that  device  to 
be  directed  to  the  file.  The  second  Keyword  following  Mount  determines  the  direction  of 
data  flow  and  the  choice  of  an  oid  (existing)  or  new  file.  A file  must  be  mounted  on  a 
device  before  any  actual  10  can  take  place. 

Af’f^END  mounts  an  old  file  for  output  only,  with  the  subsequent  output  being  appended 
to  the  previous  contents  of  the  file. 

INPUT  mounts  an  old  file  for  input  only. 

NEW  mounts  a new  file  for  both  input  i.nd  output  (the  file  is  initially  empty). 

010  mounts  an  old  file  for  both  input  and  output  (subsequent  output  overwrites  any 
existing  file  data). 

OUl  mounts  a new  file  for  output  only.  For  a disk  or  tape  device,  OUl  is  treated  as 
NEW. 

THIS- TERMINAL  associates  the  user  terminal  --  instead  of  a named  file  --  with  the 
named  device.  The  mounting  is  for  both  input  and  output  unless  a file  has  already 
been  mounted  for  one,  in  which  case  the  terminal  is  mounted  only  for  the  other.  The 
tr»'minal  is  known  to  be  an  ASCII  "file".  The  terminal  may  be  mounted  only  once  for 
input;  it  may  be  mounted  for  output  (or  on  an  output -only  device)  any  number  of 
times,  but  the  output  is  not  labeled  as  to  source. 

Only  some  of  the  forms  above  are  applicable  to  any  given  device.  Eor  a disk-  or  tape-like 
device,  an  INPUT,  OID,  or  NEW  file  is  expected;  an  OID  file  is  one  that  was  NEW  in  a 
previous  PRIM  session,  and  is  being  re-used,  while  an  INPUT  file  is  an  old  read-only  file. 
For  a bidirectional  communication  device  (e./r.j  a terminal),  two  files  arc  required:  an  INPUT 
file  and  either  an  OUTPUT  or  APPEND  file.  Alternatively,  a real  terminal  may  be  used  for 
both  (or  either  one).  For  an  input-only  device,  INPUT  and  OLD  are  identical;  for  an 
output-only  device,  OUT  and  NEW  are  identical. 


^^i^iWSTMtii^n-rnrnr 
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for  those  devices  that  deal  evclusively  with  character  data,  the  mounted  file  is  always 
taken  as  an  ASCII  text  file;  character  translation  is  perforrued  as  part  of  the  10  process. 
(This  allows  the  file  to  be  created  and/or  processed  by  any  operatinp,  system  utility  that 
deals  with  text  files.)  for  tape  and  disk  devices,  the  file  format  is  internal  to  f’RIM  (and 
therefore  not  requested  from  the  user);  the  data  is  recorded  directly,  for  other  devices 
the  user  is  asked,  via  subcommand  mode  ("»"  prompt),  whether  the  mounted  file  (NOl  the 
device)  is  an  ASCII  text  file  or  a binary  file  containing  a stream  of  pure  dat^  in  bytes  of 
some  fixed  size.  The  default  is  a binary  file  of  a device  dependent  byte  size. 

Once  a file  has  bc'en  mounted  on  a device,  all  exec  commands  that  refer  to  the  file  require 
the  device  name  as  the  specifier;  for  communication  devices,  where  two  files  are  normally 
mounted,  the  device  name  is  followed  by  a dircchon  selector.  The  file  name  itself  is  not 
used  as  the  internal  identifier. 

News  reads  the  f’RIM  on-line  news  file. 

Do  you  to  eoo  4-nPR-77  Changes  In  PRIfI  ?t 

I More  cofims  the  mossage  regarding  changes  of  4-nPK-77  ...  1 

Do  you  w.mt  to  see  24-finR-77  Preliminary  Documentation  ?!  XXX 

> 

Ihe  date  of  the  most  recent  news  message  is  shown  automatically  at  the  start  of  each 
session.  In  response  to  the  command,  each  message’s  date  and  subjeci  is  shown, 
beginning  with  the  most  recent  message,  f-or  each  message,  the  body  may  be  seen  {Y  ICS) 
or  skipped  {NO),  or  the  command  may  be  terminated  {Hririo  or  nhort). 

Peripherals  returns  information  about  the  installed  devices. 

>/)<’''^ERlPMrRnis 

Chan  Unit  tlounted  Oovice 

1 0 No  PRINTER 

2 0 Yo';  URIIlNnL 

3 0 Yt%  inPC-UNIT 

3 1 Yos  TnPFUNIT 

ar  t I VO  dovicps:  HRMINflL 

> 

This  command  produces  a listing  of  all  the  installed  devices,  tog,cther  with  their  10 
addresses  and  a notation  concerning  whether  they  have  files  mounted.  It  also  lists  all 
devices  which  have  suspended  10  operations.  Ordinarily,  suspended  operations  are  limited 
to  (1)  10  error  conditions  and  (2)  input  operations  where  the  input  file  is  a real  terminal 
and  no  input  was  available  when  target  execution  stopped. 

Qint_  terminates  a f’RIM  session. 

Quitting  fKlCHlNE  tConflrml 

e 

Terminating  the  f’RIM  session  involves  closing  all  open  files  and  returning  control  to  the 
process  that  initiated  the  PRIM  session.  The  session  cannot  bo  continued. 
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Reassign  spocilics  a new  file  for  a mounted  device. 

>reo^‘'^L.SIGN  (dpvice)  Ifi^^'^Pt-UNIT  (Jo  (He)  licwjilr^^^ 

> 

This  command  is  used  to  substitute  a new  file  specification  when,  afU  r a prior  Restore 
command,  a previously  mounted  file  cannot  be  found.  In  particular,  a restore  done  from  a 
different  directory  than  the  one  in  force  at  save  time  has  trouble  finding  any  of  the 
mounted  files.  Reassign  may  only  be  used  for  devices/filcs  that  are  marked  "[not 
opened]"  in  a file  status  display.  Ihe  new  file  is  assumed  to  have  the  same 
characteristics  as  the  old  one  and  is  positioned  at  the  same  file  position. 

Restore  recovers  the  state  information  saved  in  a file. 

>rr.<<’-'^T0Rr  (from  SRVC  file)  /l/fC/l.CO/Vf’/C; 

restored  CONF  IGURni ION  from  TUESDRY,  flRY  3,  1977  12:39:08  POT 

> 

Ihe  current  context  is  updated  with  the  complete  or  partial  environment  previously  saved 
in  the  designated  file  by  the  Save  command.  For  the  addressable  regions  --  machine 
memory,  registers,  etc.  - the  saved  data  replaces  the  current  data  only  for  those  cells 
that  were  actually  saved  cells  not  saved  are  not  cleared.  (I bus,  nonoverlapping  memory 
images  arc  merged.)  For  nonaddressable  regions  --  symbol,  configuration,  and  breakpoint 
--  each  one  is  completely  replaced  if  present  in  the  file.  Ihe  date  and  region(s)  saved  are 
shown,  followed  by  a list  or  any  mounted  files  that  cannot  be  found. 

Rewind  returns  a device’s  mounted  filc(s)  to  the  beginning. 

>rcm^-'^INn  (drvice)  In^^f'PE-UNIT 

>rei#»  I NRL  (R,I,0,?)  ? One  of  the  folloMing: 

Bniii 

INPUT 

OUTPUT 

>fUI4  TERniNOl  /'••'^‘NPUT 
> 

Ihis  command  is  useful  for  retrying  a program  without  unmounting  and  remounting  files. 
(Files  arc  always  rewound  when  mounted,  except  for  Append  files,  which  cannot  be 
rewound.)  For  a terminal-like  device  that  requires  separate  input  and  output  files,  the  user 
optionally  specifies  which  file  is  to  be  rewound;  the  default  is  liOl'II. 

Save  copies  selected  state  information  into  a file. 

y Onn  of  Iho  follouingt 

nil 

CONE IGURRT ION 
roRunTs 
Ml  MORY 
SYMBOLS 

>SnVE  r^'^ONf  IGURUTION  (on  flln)  nllCIlCON!' 

> 

This  command  saves  on  the  (new)  file  an  image  of  the  region(s)  selected  for  saving.  The 
contents  of  the  file  can  later  be  restored  for  use  in  this  or  another  session,  the  second 
word  of  the  command  selects  one  of  the  save  options. 
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All  saver,  evcrylhinp,  --  a complete  checkpoint  of  the  tari’.cl  nuuliinc  and  dcbiippinp 
stale.  "t  vcrythinp”  includes  memory,  all  addressable  rcpisters,  installed  devices, 
mounted  filer,  together  with  their  positions,  debup  bre.^Kpoints  and  their  programs, 
debup  formats  and  modes,  defined  symbols,  and  the  internal  state  of  the  emulated 
mac  hine. 

CONFIGURATION  saves  all  the  machine  confipuration  data,  includmp  installed  devices, 
n^ounted  files  (if  any),  machine  parameters,  and  debup  formats  and  modes.  This 
command  is  allowed  only  before  any  execution  takes  place.  Useful  for  creatinp  a 
standard  machine  confipuration  (possibly  with  some  standard  files  mounted)  for  use  in 
subsequent  sessions. 

FORMATS  saves  all  the  formats  that  have  been  defined  (usinp  thc'  debupper  Format 
command). 

Ml  MORY  saves  those  repions  of  the  machine  memory  that  arc  not  clear.  (At  thc  start 
of  a RRiM  session,  memory  is  already  cleared.) 

SYMFtOLS  saves  all  the  uscr*defincd  symbols,  both  those  loaded  via  the  exec  Symbols 
command  and  those  defined  direct'y  via  the  debupper  New-symbols  command.  The  file 
that  results  Is  a SAVL /F^FSTORF  file,  not  a SYMROLS  file! 

Set  chanpes  thc  values  of  uscr-scttable  parameters. 

(<-ptnp|g>  or  riovlc^) 

>>?*  Oi»n  of  thn  (olloMing: 

Cl  net. 
ninoRY 
SIM  fO 

>>^.e.sr|  nCK  (ticlK  per  surond) 

(fil  modulor.) 

>>e» 

(vpnip|g>  or  drvice) 

>>.se.<ep{;f  n (rh.iractors  por  second) 

»rr 

> 

F ollowinp  the  command  word,  thc  user  selects  the  proup  of  parameters  he  wishes  to  alter. 
An  immediate  rritirn  selects  the  global  machine  parameters;  a device  name  selects  the 
parameters  of  that  particular  installed  device  (the  parametf'rs  of  multiple  installed 
instances  of  the  same  device  type  need  not  have  identical  settings). 

Any  number  of  parameters  from  the  selected  proup  may  be  changed.  In  response  to  thc 
subcommand  prompt  ("»”),  the  name  of  a parameter  and  its  new  value  are  entered;  each 
change  is  made  immediately  and  a new  subcommand  prompt  appears.  Ihe  command  is 
terminated  by  an  empty  Input,  rrtnnt  only,  or  by  an  nhnri  (which  does  not  undo  any 
parameters  previously  changed).  TFie  list  of  possible  parameters  is  highly  machine  and 
device-dependent;  it  typically  includes  the  size  of  memory  and  thc  speed  of  each  device. 

The  value  of  a parameter  is  either  a (decimal)  number  or  a keyword  from  a 
parameter-specific  list;  a qiiostion  in  the  value  field  reveals  which  is  expected.  An  pficnpn 
sets  thc  parameter  to  Its  default  value. 
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Show  displays  thr  valurr.  of  all  tho  parameters  in  a group. 

ysIt^^^OU  <<rf»ip(g>  or  device) 

Cl  nCK  li>  1000  tlc>s  per  second 
ninORY  Is  A BK  modules 

Sf’lFO  Is  7b0  n.mosoconds  per  memory  cycle 

(<rmply>  or  device)  p^A^'RINTER 
SPirn  Is  ?O0  characters  per  second 

> 

Following  the  command  word,  the  user  selects  cither  the  global  machine  param^'lcrs 
irrhirn)  or  the  parameters  of  an  installed  device.  The  names  and  current  vames 
of  all  the  paramolers  are  displayed. 

Symbols  reads  an  ASCII  symbol-table  file. 

>.^y^Arf,f,0IS  (from  file)  SY  M llOhS.I^X  AM 
> 

This  command  causes  F’IdM  to  build  a user-defined  symbol  table  from  the  data  in  the 
named  file,  which  is  a structured  ASCII  text  file.  Ihc  file  may  define  values  for  both  global 
symbols  and  pi  ogram-local  symbols  that  are  organized  into  programs.  In  the  f’IdM 
debugger,  the  global  symbols  plus  the  local  symbols  of  the  currently  open  program  are 
accessible  at  any  time.  Symliol  values  in  the  file  are  octal.  I he  form  "name  value" 

defines  a global  symbol;  the  form  "name  *=  value"  defines  a local  symbol;  the  form  "name:" 
establishes  a program  name  to  which  subsequent  local  symbols  are  assigned.  Tho  file  is 
free -format  in  that  spaces,  tabs,  commas,  and  new-lirics  may  occur  anywhere  --  except  in 
the  middle  of  names  or  values.  The  following  is  a sample  symbols  file. 

Alf’IIA-  Ob 
ttf  I A- = 123/15 

I’Kl;  A-2000,  B-2132,  C=  2241 
XY/: 

A- 32 12  AA=3245,  AAA=3261,AAAA-7/77 

Symbol  files  are  intended  to  support  the  moving  of  symbolic  label  data  from  an  assembler 
or  linking  loader  into  f’IdM  for  use  in  symbolic  debugging. 

Time  displays  time  of-day  and  time-used  information. 

(ifi)  lursonv,  nnv  3,  1977  i?;3A:33-pot 
U’wrf  0:14.6  PRin  timo;  U^od  0:02.7  HIP  time. 

> 

This  command  displays  tho  date,  time  of  day,  the  amount  of  F*h!M  tin^c  used  and  the  amount 
of  Ml  F’-900  time  used  In  this  PKIM  session.  (Elapsed  target  machine  time  is  displayed  In 
response  to  niniiis.) 

T ranscript  transcribes  the  subsequent  PRIM  session  on  a new  file. 

>P^-'^nN5CRIPT  (to  file) 

> 

All  transactions  with  the  user  terminal,  including  exccution-tirae  10  to  T I IIS-T LRMINAL,  is 
transcribed  until  either  tho  user  terminates  the  session  (with  a Quit  command)  or  closes 
the  transcript.  Only  one  transcript  may  be  open  at  a time.  A header  line  containing  the 
date  and  time  is  placed  at  the  head  of  the  file. 


mUsi. 
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Uninstall  removes  an  installed  device. 

>liMl^''^NSini  I (tU  vico)  / PPINIIR  or  lOPF  NIT 
xUNINSinil  (clrvice)  lo^'^PE-UNU  <un  M ) : 

> 

this  command  is  tiu'  inverse  ol  the  Install  command;  it  removes  an  installed  device  from  the 
configuration,  first  unmountinp,  its  files  if  necessary. 

Unmount  unmounts  the  file(s)  from  a device. 

>|ifiiM^'«0llN1  (Hovicp)  ;^^'‘«’RINUR 

(R,I,0,?)  ? One  ol  the  lolloMlnq; 

ROIH 

INPUT 

nillPUT 

>UNn  TERrilNflL  noTH 
> 

The  unmounted  filefs)  are  closed,  for  a terminal-liKc  device  that  requires  separate  input 
and  output  files,  the  user  optionally  specifies  \A'hich  file  is  to  be  unmounted;  the  default  is 
ttOTH. 
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PRIM  DEBUGGER 

Ihc  PRIM  drbunRer  is  a I able -driven,  tarpct-machinc- indrpondoni,  interactive 
propram  for  debuppinp  a PRIM  emulator  or  a target  program  running  on  such  an  emulator. 
It  is  tailored  to  a specific  target  machine  by  tables  prepared  as  part  of  an  emulation  tool. 
Hasically,  it  permits  a user  to  set  and  clear  breakpoints  and  to  examine,  modify,  and 
monitor  target  system  locations,  larget  system  assembly  language  and  symbolic  names 
arc  recognized,  and  arithmetic  is  performed  according  to  the  conventions  of  the  target 
machine.  Ihe  debugger  command  prompt  character  is  each  level  of  subcommand  adds 
another  "f”  to  the  p;ompt. 

ARGUMENTS 

Most  riebugger  commands  take  arguments  in  'he  form  of  vali  s,  expressions, 
r xpression-ranges,  lists  of  expressions,  or  lists  of  expression-ranges  as  defined  below. 

Values 

A value  is  an  assembly-language  instruction,  a form,  text,  or  ar<  expression- list. 
Assembly  language  instructions  arc  parsed  by  a table-driven  asscmbicr/disassembicr  that 
accepts  the  same  syntax  as  the  assembler  for  the  Jarget  machine.  User  symbols  will  be 
recognized  if  they  have  been  supplied  in  user  symbol-table  files  (see  the  exec  Symbols 
command)  or  have  been  declared  individually  (see  the  debugger  New-symbol  command). 

A form  requires  that  the  user  previously  define  a corresponding  format  (sec  the 
d(  hugger  Format  command).  A form  is  represented  by  the  format  name  followed  by  an 
expression-list,  as  in  the  following  example. 

FI  0,  7,3 

Text  is  represented  as  a double-quote  (”),  followed  by  an  arbitrary  delimiter 
character,  followed  by  a sequence  of  other  (non-delimiter)  characters,  followed  by  another 
Ofcurrence  of  the  delimiter  ch;  acter,  as  in  the  following  example. 

"/I  his  is  text./ 


Expressions 

An  expression  is  any  well-formed  sequence  of  constants  and  symbols  that  arc 
cic'fincd  for  the  target  machine;  the  symbols  (which  are  machine-specific)  may  represent 
eitlic’r  locations  or  operators  whose  rules  of  combination  determine  what  is  a well-formed 
e xpression.  A location  symbol  may  represent  a named  hardware  eiement  or  a globally  or 
locally  defined  user  location.  An  operator  may  cither  be  unary  (preceding  its  operand)  or 
binary  (coming  between  its  operands  in  infix  notation).  Ihe  precedence  of  operators  is  a 
function  of  the  target  machine,  except  that  all  unary  operators  arc  assumed  to  have  the 
same  precedence  value,  which  is  higher  (more  strongly  binding)  than  that  for  any  binary 
operator.  If  brackets  are  permitted  ir.fr.,  parentheses),  their  precedence  value  is  hij.lier 
than  that  of  unary  operators.  For  example,  A-B  and  -B4A  will  evaluate  the  same,  but  will 
differ  from  -(BkA),  which  will  evaluate  the  same  as  -U-A  A bracketed  subexpression  may 
il  elf  attain  the  full  complexity  of  an  expression.  Ihe  behavior  of  operators  is 
machine-specific. 
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Expression  ranges 

An  exprcGsion-ranpe  consists  of  the  triple:  expression  (lower  bound),  colon, 
expression  (upper  bound).  It  represents  a sequence  of  locations  startinp  at  the  lower 
t)Ound  and  continuinp  throuph  successive  locations  to  ind'idc  Ihe  upper  bound.  Ihc  upper 
bound  may  not  be  ess  than  the  lower  bound.  Wherever  an  expression-ranpe  's  allowed,  a 
sinple  expression  is  accepted  and  treated  as  if  it  had  been  entered  as  both  the  lower  and 
upper  bounds  of  a ranpe.  If  the  two  bounds  in  a ranpc  address  different  spaces  (sec  the 
discussion  of  Spaces  below)  within  the  target  machine,  the  sequence  of  locations  is 
restricted  to  that  space  addressed  bv’  the  lower  bound.  Two  special  forms  of  expression 
ranges  are  recognised.  If  the  second  expression  in  a range  is  it  is  treated  as  being 
the  largest  address  in  the  space  referenced  by  the  first  expression,  tf  the  second 
expression  In  a ranpc  is  of  the  form  "♦  ri-prrji.iioM'',  it  is  treated  as  if  it  were  "(lower 
hntii.d)  * expression." 

Lists  of  expressions  or  ranges 

A list  of  expressions  consists  of  at  least  one  expression,  followed,  optionally,  by  any 
number  of  occurrences  of  a comma  followed  by  an  expression.  A list  of 
expression-rangcf  has  the  corresponding  structure  of  a!  least  one  ranpe,  followed, 
optionally,  by  any  number  of  occurrences  of  a comma  followed  by  a ranpe.  An  example  of 
a list  of  ranges  is 

0:10,  20,  30:50 

Note  that  the  second  element  of  the  list  (20)  is  an  example  of  a ranpe  with  a defaulted 
upper  bound. 

SPACES 

Addressable  locations  in  a target  system  are  organized  into  constructs  called  spaces. 
A space  consists  of  a set  of  addressable  locations  that  is  closed  under  a successor 
function  and  its  inverse  (a  predecessor  function).  For  example,  main  memory  constitutes  a 
space,  typically  starling  at  location  zero  and  continuinp  through  an  arbitrary  number  of 
locations.  Ihe  successor  to  the  last  element  of  a space  is  the  first  clement  in  that  space; 
arid  the  predecessor  of  the  first  element  is  the  last  one.  In  some  cases,  machine  locations 
are  grouped  into  a space  for  convenience,  even  when  the  concept  of  a successor  function 
for  elements  of  that  space  has  no  correspondence  in  the  actual  target  system.  Such  a 
space  might  consist  of  testable  indicators.  Ihe  machine  symbols  are  identified  in  the 
tool- specific  user  guide. 

For  purposes  of  the  debugger,  every  addressable  location  in  a target  system  is 
represented  by  a pair:  (spnre^  element).  When  a range  is  specified,  two  such  pairs 
(n,h):(e^fi)  arc  implied.  lo  avoid  ambiguities  where  n and  r differ,  the 
debugger  ignores  r and  treats  such  a range  as  a sequence  of  locations,  al!  in  space  n, 
starting  with  clement  h and  continuing  through  element  d. 

SYNTACTIC  UNITS 

Ihc  basic  syntactic  units  the  debugger  deals  with  are 

1.  Literals 

2.  Symbols 

3.  I’unctuation 
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Literals 

Literals  are  character  constants,  numeric  constants,  or  sinpje  characters  that  have 
some  encoefed  meaninp,  (which  may  be  context-dependent).  A character  constant  is 
siif^plied  to  tlie  drbug{’,er  as  a machine-specific  character-constant  prefix  strinp,  followed 
by  a string  of  data  characters  of  arbitrary  length,  followed  by  a machine-specific 
char.icter-constant  suffix  siring  of  the  general  form: 

chnracter~dnin-%lrinf(  fuffix~ntrinf[. 

If  the  first  character  of  the  suffix  string  is  to  be  included  in  the  data  string,  it  must  appear 
doubled.  Character  constants  are  converted  to  binary  (right  justified)  and  are  truncated 
to  fit  the  element  in  question.  As  the  form  of  a character  constant  is  mactiine-specific,  it 
is  described  in  the  tool-specific  user  guide. 

A numeric  constant  is  supplied  to  the  debugger  as  a mactvne-specific  (and  optioral) 
radix- prefix  string  followed  by  a string  of  digit  characters  followed  by  a machine- specific 
(and  optional)  radix-suffix  string  of  the  general  form: 

luofix-xtring  digit-nlring  f fix- string 

I hc’  prefix  and  suffix  strings  establish  the  radix  within  which  the  digit  characters  are 
f'valu.itcd.  the  digit  characters  for  any  radix  r are  the  first  r characters  of  the  set 
{0.....9,A,...,-Z}. 

Coded  characters  have  Independent  meaning  only  within  certain  contexts:  at 
a^ipropriale  points  in  the  dialogue  they  designate  a particular  debugger  command,  a mode, 
a 1)1  raKpoint  type,  etc. 


Symbols 

There  are  five  types  of  symbols:  machine  symbols  that  are  as'.igned  to  hardware 
elements  in  Ihe  target  machine,  predefined  opcodes  for  syml>olic  instructions, 
user -supplied  names  of  formats,  operators  for  expressions,  and  user  symbols  that  can  be 
assigned  to  arbitrary  memory  locations.  Machine  symbols  are  given  in  the  tool- specific 
user  guide;  other  symbols  are  assumed  to  be  familiar  to  the  user. 

User  symbols  are  either  loaded  from  a file  using  the  exec  Symbols  command  or 
ifidividually  defined  using  the  debugger  new-symbol  command.  The  symbols  include  both 
global  symbols  and  program-local  symbols  that  belong  to  specific  named  programs.  The 
global  symbols  are  available  at  all  times;  the  program-local  ones  only  when  theirs  is  the 
open  local  symbol  table. 

Punctuation 

Punctuation  marks  are  characters  with  a predefined  syntactic  (and  usually  semaidic) 
role.  The  punctuation  characters  are  the  separators  {comma  and,  in  format  definitions, 
spnee)^  Ihe  terminators  {return,  escape,  and,  in  replacement  operators,  hnck-slnsh  and 
up  arrow),  and  a semantics-free  delimiter  {space).  I'lscape  is  used  as  a terminator 
instead  of  return  to  invoke  a subcommand  or  an  additional  feature  of  a command  {e.g.,  in 
Mode  or  Breakpoint  commands  described  below). 
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ERROR  DETECTION  AND  EDITING 

f)ebup,p.cr  commands  arc  examined  for  errors  as  they  arc  entered,  character  by 
character.  As  soon  as  an  error  has  been  detected,  a bell  (beep)  is  echoed  and  further 
input  is  rejected,  except  for  the  Reneric  editing  characters  /mrA-A/mre,  roiy/m,  bnrknp, 
fIrlotOf  or  ahort. 


COMMANDS 

Debugger  commands  are  all  single  characters;  they  can  be  organized  into  several 
grOLfps:  debugger  control,  execution  control,  display,  and  storage.  Fach  is  listed  below. 
Unit'ss  otherwise  Indicated,  the  command  character  is  the  first  character  of  the  command 
flame. 


Debugger  Control 

Debugger  Control  commands  provide  for  user  control  over  several  aspects  of  the 
Ix'havior  of  the  debugger.  They  permit  the  user  to  execute  commands  indirectly  or 
conditionally,  to  return  from  the  debugger  to  the  PRIM  exec,  and  to  control  the  debugger’s 
representation  of  data.  The  Debugger  Control  commands  are: 

ll.c.  Calls  a designated  break-time  program  as  If  some  breakpoint  associated  with  that 
program  had  just  occurred.  A program  number  must  be  designated  that  corresponds  to  an 
evir.tii^,  ‘''reak-time  program.  Program  numbers  are  shown  when  the  breakpoint  data  base 
is  displayed  (see  the  break  command);  the  program  itself  can  be  seen  using  the 
program* edit  command. 

i/Uso  program  /^(niimhor  of  an  existing  breal(  program) 
i^Unn  • program  2*'^ 

If  the  use  command  is  itself  in  a break-time  program,  then  a go  command  executed  in  the 
< ailed  program  causes  termination  of  the  calling  program  as  well  as  of  the  called  program. 

[f.  Tests  the  supplied  expri  sion  and,  if  it  is  true,  executes  the  following  subcommand.  A 
true  expression  is  one  whose  value  Is  odd-,  relational  operators  yield  a value  of  one  when 
true  and  zero  when  false.  The  tested  expression  must  be  terminated  by  an  esenpo. 
ffli  7(oxpi  Gsr.  Ion) 

If  <thrn>  #i'7’ijpo  0^^ 

00:  00  # 

ffl{  2^^^-  <thnn>  #4'7'gpe  0^^ 
t 

fOeturrK  Returns  control  to  the  PRIM  exec;  confirmation  is  required. 
ff!\o\urn  (to  FXEC) 


> 


t 
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Mod(^  Inlerropafes  default  and  current  modes  and  changes  modes.  A r/iirxiion  after  the 
command  character  hi  will  elicit  the  default  and  current  mode  setting;  another  qnexiiou  will 
list  all  mode  sellings  and  associated  mode-code-characters. 
ifhlodG  ? 


Current  and  (Oo(ault)  mods  tattlngfii 


r cpdbctck 

Output 
RddracEes 
L Inn-format 
Radix 

Typo  ? for  mora 


Verbose 

Bits 

Symbol  Ic 

Dense 

B 


(Verbose) 
(Bits) 
(Symbol Ic) 
(Dnnse) 

(8) 


#Uode  ? 

Fondback i 

C Cone  I so 

V Vnt  bose 

Output  I 
B Bits 

F Formatted  ( forma t>nama) 
I Inr.  true  t Ion 

N Numeric 

1 loxt 


nddressest 

n nh<^olute 

S Symbolic 

I ino-format : 

0 DcniiO 

F . Fxpandod 
Radix* 

Rn  Radix-baso  n (1  < n < 37  docimal) 

n 

A list  of  mode  settings  is  expected  following  the  Mode  command;  if  none  is  supplied,  the 
clrfauH  settings  arc  reestablished.  If  the  list  is  terminated  by  a rriiirn,  the  current  modes 
iiff?  changed.  If  the  list  is  terminated  by  an  cara/m,  a temporary  change  is  made  that 
applies  only  to  the  following  subcommand,  as  in  the  following  example. 

ffhloda  /nt.  true t Ion  fi'/’ypo  01234^^ 

01734 1 JUIlf’  0S67 

0 

Modes  are  established  for  feedback  (verbose  or  concise);  output  (bits,  formatted, 
iiK.fruclion,  numeric,  or  text);  addresses  (absolute  or  symbolic);  output  line  format  (dense 
or  expanded);  and  output  radix  (any  base  from  2 through  36). 


Ihe  feedback  modes  control  how  debugger  commands  are  reflected  to  the  user: 
roitrixfj  suppresses  all  "noise"  feedback  (such  as  command  completion);  vcihoxc  enables 
it.  The  output  modes  control  the  general  representation  of  data:  hii.%  treats  a datum  as  an 
unsigned  magnitude;  formatted  treats  it  as  a pattern  of  bits  partitioned  into  contiguous 
fif'Ids  according  to  a dcsigna*ed  format  (sec  Format  command);  insinirtinn  treats  it  as  a 
machine  instruction  and  disassembles  it;  munfric  treats  it  as  a signed  value,  if  that  is 
appropriate  for  the  machine;  and  text  treats  it  as  a representation  of  a string  of 
characters.  Ihe  address  modes  control  whether  numeric-mode  values  are  to  be  converted 
to  symbols  (if  possible):  ahxoluta  suppresses  the  symbol  look-up;  xymbolic  enables  it.  The 
line-formal  modes  control  the  density  of  displays:  dcune  suppresses  most 
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debugger-generaled  line-feeds  so  as  to  show  more  information  per  line,  expanded  enables 
them. 


When  formatted  output  is  selected,  the  name  of  the  output  format  must  be  specified, 

as  in: 

#A/ode  /'orm.^ttoH  h i 

Output  radix  sets  the  number  bas^  for  the  representation  of  numeric  data  (note  that 
numeric  input  data  scif-identify  the  number  base).  For  example, 

#^/odo  Kfldix  16 

causes  current  output  radix  to  become  hexadecimal. 

Format.  Permits  the  user  to  name  and  define  a format  as  a list  of  fields,  each  of  which  is 
a designated  number  of  bits  wide.  The  field  widths  are  supplied  as  a list  of  numeric 
constants  (separated  by  commas  or  spaces). 

#/•  orm.it  2 4 6 

i 


#A/ode  F’oi  m.itted  h' I ##7'ype  0^^ 

OOt  80,00,60,00  # 

If  the  format  command  is  terminated  without  having  defined  a format,  all  defined  formats 
arc  displayed,  as  in 
ar/'  orm.it 
f l 2, 4, 6, ft  # 

Comment.  Following  an  initial  semicolon,  ignores  all  subsequent  inputs  up  to  and  including 
a line  terminator. 

/f;  mis  IS  /}  cohfhiim-ir  does  not  get  iNri:iiriu:rh:Ds^ 

a 

Mew-symbol.  Adds  a list  of  new  user  symbols  to  the  (possibly  empty)  global  symbol 
table,  tach  new  symbol  in  the  list  is  supplied  as  a name  followed  by  a .</jore  or  an  eaenpe 
followed  by  an  expression  giving  its  location. 

#/Vr-M-byml)ols  /^ ( ( (now-sgmbo I ) <ESC>  (expression))-!  Ist) 
i^Nf-M-r.gmholr.  V/MCU*'^*'  <al>  070000" 

ij'/ypo  rm(:ii,rmx:ihEr/]TCihif'r 
PniCHj  00  OS7777:  00  PnTCH<01t  08  i 

Kill-symbol,  f^rmoves  a list  of  user  symbols  from  the  open  local  or  global  symbol  table. 

#K  I I l-sgtnl>ols  ?(l  l6t-o(-user-Egmbols> 

I II  - r.gmho  I s r/irciif'r 

#7’ypo  067777:K*('’- 

OG7777:  00  070000:  00  670001:  00  # 

Open-symbol-tahic.  Opens  a local  (program-specific)  symbol  table  if  one  is  specified;  the 
currently  open  local  symbol  table,  if  any,  is  closed  in  any  case.  Afler  this  command  is 
executed,  the  available  symbols  Include  the  global  symbols  plus  the  local  symbols  of  the 
specified  program;  if  no  program  is  specified,  only  the  global  symbols  are  available. 

jTOpon-program- symbol*  /'(program-name)  or  not  <close  the  open  local  symbol  tablo> 
#0pen-program-symbols 
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Execution  Control 

Ixeculion  control  commands  provide  for  user  control  over  execution  of  the  tarpet 
piop.rnm.  They  permit  the  user  to  continue  execution,  transfer  to  a clesipnatod  location, 
'.('t  and  clear  breakpoints  or  edit  break-time  programs,  and  single- step  the  tarpet  program. 
1 he  execution  control  commands  arc 

('n.  Passes  control  to  the  tarpet  machine  in  its  current  state.  If  an  argument  is  supplied, 
its  value  is  first  stored  into  the  program  counter.  The  argument  can  be  an  arbitrary 
expression,  so  long  as  it  evaluates  to  a legal  memory  address. 

/iCo  (to)  /^(nvprp'-.s  ion)  or  empty 

/f(,o  (to)  oimmr 

pK'ak.  Displays  or  sets  breakpoints  in  the  tarpet  machine.  Ihe  two  classes  of 
i)reakpoints  are  known  as  event  breakpoints  and  reference  breakpoints.  There  is  a fixed 
sf  t of  event  breakpoints  defined  for  any  given  target  machine;  each  describes  a type  of 
( VC  fit  whose  occurrence  causes  the  emulator  to  break  if  the  corresponding  event 
breakpoint  is  set.  The  set  of  event  breakpoints  always  includes  U)  every 
in  Iruction- execution  (single  step),  (2)  every  branch  of  control,  and  (3)  e very  memory 
vyrite;  other  events  arc  defined  for  each  machine  as  appropriate.  I^eference  breakpoints 
(.mse  the  emulator  to  break  when  a specific  type  (rc'ad,  write,  and/or  execute)  of 
n ference  to  a specific  location  occurs.  Reference  breakpoints  may  always  be  set  on 
uir  rnory  locations:  other  spaces  in  which  reference  breakpoints  may  be  set  are  detailed  in 
the'  tool  specific  user  guide.  Any  nurnber  of  reference  breakpoints  may  be  set  at  any 
time. 


The  break  command  followed  immediately  by  a rcitirn  causes  all  exist  ini’,  breakpoints 
(i.o.,  those  in  the  breakpoint  data  base)  to  be  displayed;  if  a hreak-lime  program  is 
associated  with  a breakpoint,  its  number  is  also  displayed.  Otherwise,  a list  of  either 
t'vc'nts  or  ranges  (reference  locations)  for  the  setting  of  breakpoints  is  supplied.  If  a list 
of  ranges  has  been  entered  and  terminated  with  an  r.srepr,  then  a list  of  read,  v/ritr,  or 
exf'cutc  reference-break  conditions  is  specified  next  (as  pr  rmitted  at  those  locations);  tiu' 
default  is  all  three  types.  Whenever  a breakpoint  is  set  for  an  event  or  a location,  any 
earlier  breakpoint  for  that  same  event  or  location  is  superseded. 

If  the  list  of  events  or  break  types  is  terminated  by  an  rsm/u',  as  in  Ihe  second 
example  below,  a break-time  "program"  may  be  supplied  to  be  exccutf'd  by  the  clebugf'.er 
when  the  break  is  encountered.  The  following  commands  arc  prrm'lird  within  such  a 
break  program:  Clear,  Comment,  Dcbrcak,  Lvalualc,  Go,  If,  Jump- history,  locale.  Mode, 
Open,  Set,  Type,  and  Use.  Replacement  wittiin  a locate  or  type'  command  is  not  permitted 
in  cl  brurik-tiiiio  piogram.  Any  number  of  commands  can  be  included  in  a break  program; 
the  program  is  terminated  by  an  empty  command  (terminator  only). 
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iltroak  (At)  (nvent  - I I f,  t ) or  ( (express  ion  ranga)  - 1 is  t ) or  <RMIIRN> 
<?  (or  list  ol  evpr»ts> 

/Break  (at)  0 1 2.'l:0if>6,  07 12^^^  (after  doing) 

<R,M,X>  # 

//freaic  (at)  0 1000^^^  (alter  doing)  Xecuta 

#/7’ypo  0^^ 

MfiCo  (to) 

<P»'ogram  mitnbnr  Is  (1)>  / 


//freak  (at) 

0 

//freak  (at) 

01P3.0456  <R,U,X>  071?  <R,U,X>  01000  <X>[11  TICK  <Qvont>  / 

Diirinc  procram  execution,  if  an  event  break  is  detected,  or  if  a reference  break 
(read,  write,  or  execute)  is  detected  at  a location  for  which  the  correr.pondinp,  break  type 
has  been  specified,  then  execution  is  terminated  before  bepinninp  the  next  target  machine 
cycle  and  control  passes  to  the  debugger  to  process  the  break.  If  a break-time  program 
has  been  supplied  for  that  break  event  or  location,  the  program’s  commands  are  executed 
in  order  by  the  debugger  until  either  a go  command  or  the  end  of  the  program  is 
encountered.  If  s('veral  breaks  occur  on  the  same  cycle,  the  program  associated  with  each 
of  them  Is  executed;  the  order  of  break-program  execution  corresponds  to  the  order  in 
which  the  breaks  are  reported  by  the  emulator.  If  every  break  causes  execution  of  a Go 
command,  then  the  target  program  is  automatically  resumed,  provided  there  is  no 
ambiguity  as  to  where  execution  is  to  resume.  Otherwise  (i.o.,  if  any  break  had  no 
program  or  failed  to  execute  a Go  command),  a messagt:  describing  each  of  the  breaks  is 
displayed  and  tfic  normal  command  level  of  the  debugger  is  entered. 

Oebreak.  Clears  event  breakpoints  or  reference  breakpoints  at  locations  in  the  target 
machine.  The  default  is  to  clear  all  breakpoints.  Examples  of  debreak  commands  are 

//Icbreak  (from)  02Hi:^i^'^ 

0lire^y.  (at) 

0173- 0?33  <R,W,X>  0741-045B  <R,U,X>  071?  <R,U,X>  01000  <X>(n 

TICK  <ovent>  / 

///nbroak  (from)  all  Ironflrml^^ 

//freak  (at) 

0 

FVogram-edit.  [Tisplays  a designated  break-time  program  or  permits  it  to  be  edited.  A 
program  number  must  be  designated  that  corresponds  to  an  existing  break-time  program. 
Program  numbers  are  shown  when  the  breakpoint  data  base  is  displayed  (see  the  break 
command).  If  the  command  is  terminated  by  a return,  the  entire  program  Is  displayed;  If 
by  an  exrnpe,  the  program  is  displayed  line  by  line  for  editing. 
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(«t) 

ifi'l'npn  6y'()l,IK,CS^ 

«iCo  (to) 

naf'f 

<Pt  oqt  am  niimhrr  Is  (?)>  i/lreitk  (at) 

01?3-0;>,13  <R,W,)(>  0;'4i-04SG  <R,M,)(>  87]?  <R,U,)(>  8J000  <X>in 

lift  «pvent>  SUP  <ovenl>l2I 

#/Vogram  edit  /'(program- number)  (<ESC>-to-ed  I ( or  <RE  1URN>- to-vlew) 

4'1’rogram  nrtit  2*  ^ 

Ujpo  f 01  (ICC 
Go  (to) 

n 

WItrn  editinp,  a line  of  a break-time  program,  the  user  can  specify  that  the  next  (\)  or 
prior  (f)  line  be  displayed  or  that  a replacement  (R)  of  the  current  line  or  an  insertion  (I) 
in  front  of  the  current  line  be  made.  Editinp  is  terminated  by  an  empty  editing 
specificalion.  Replacement  or  insertion  is  identical  to  the  specification  of  a break-time 
program  within  the  break  command  in  that  a subcommand  mode  is  entered  where 
successive  break-time  commands  can  be  entered  until  an  empty  command  is  supplied;  then 
editing  continues  with  the  next  line  of  the  program.  An  extra  (dummy)  last  line  Is  added 
when  editinp  a program  so  that  new  commands  can  be  inserted  at  the  end;  the  dummy  line 
is  discarded  when  the  command  is  terminated. 

;#'/ Vofjram- ort  t ( 2^'^^ 

lupo  fOl.nCC  i/'d  <prlor>)  or  (\  <nexl>)  or  ((l<nsort>)  or  (R<rplac.e>) 

(roinm.inrir. ) ) 

Type  fOI  nCC  j Replace 
jy//Mo(le  /nstrucllon  #4^#7ype  (^OLI)CC^^ 

//if'r 
Go  do) 

oqram  oH  1 1 2*'’ 

Moclr  Instruction  jT/^i^Type  pOLDCC 
Cc  (to) 


Sing.lc- step.  Iransfers  control  to  the  target  program  through  the  program  counter  for 
execution  of  one  instruction.  The  single  coded  character  lino  feed  effects  this  command. 


Display 

Ihe  display  commands  permit  the  user  to  search  or  examine  the  contents  of 
designated  locations  (and,  in  two  cases,  optionally  permit  their  replacement)  or  to  evaluate 
expressions.  Ihecf  imands  are: 

lypcs  Displays  location  and  contents  of  a list  of  expression-ranges,  permitting  the 
contents  of  each  location  to  be  replaced  if  the  list  is  terminated  by  an  osr.npo,  as  in  the 
following  example. 

/'/’ypo  y ( (rypi'or>f.ion-rflnqo)~l  I si)  opt  lonal-<oscape>-lo-inodi  (y 
it^lype  00;  00  r /cr 

01;  00  = 2^^ 

0?t  00  r .V  r 
H 

The  replacement  value  can  actually  be  a list  of  expressions,  the  values  of  the  expression 
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in  the  lint  poinp  into  successive  locations  starting  with  the  one  last  displayed.  If  no  new 
value  Is  supplied  before  the  terminator,  the  existing  value  is  not  modified. 

#7’ypo  00:  01  = 01:  02  » 0?:  03  r /r^r  g 

In  Display-with-rcplaccmont  only,  the  coded  characters  hnrk-xinsh  and  nif-nrrow  can 
also  serve  as  terminators  and  perform  special  functions:  hnrk-xinsh  causes  the  next 
location  to  be  displayed  for  replacement  and  up~orrow  causes  the  prior  location  to  be 
displayed  for  replacement;  both  of  these  terminator  characters  permit  the  user  to  step 
beyond  the  limits  of  the  ranges  entered  as  arguments  to  the  Type  command. 

#7Vjp*  010:  00  . tt  07:  00  » 2\  010:  01  r .7\  011:  00  - t 

010:  03  = 71  07:  02  - fit  06:  00  - \ 07:  05  r \ 010;  04  r \ 

Oil:  00  r r)\  012:  00  . 

# 

The  last  location  displayed  by  a type  command  becomes  the  "open"  location,  and  the 
location  following  the  last  one  displayed  or  replaced  becomes  the  "next"  location  (see  the 
next  four  commands). 

Sania  Redisplays  the  "open"  location  (sec  the  Type  command).  Ihc  single  coded 
character  ":"  effects  this  command.  The  commands  Same,  Prior,  and  Next  are  all  shown  in 
the  following  example. 

02:  01  Jf]  01:  02  #\  02:  01  i\  03:  00  # 

Prior_^  Displays  the  location  at  one  less  than  the  "open"  location  (see  the  lype  command). 
The  single  coded  character  iip-nrrom  effects  this  command.  Sec  the  examples  under  Type, 
Same,  and  Equals. 

Next^  Displays  the  "ne  xt"  location  (See  the  Type  command;  the  n)ode  in  which  the  open 
location  was  last  displayed  determined  how  far  it  was  advanced  to  the  "next"  locations.) 
The  single  coded  character  hnrk-tlnxh  effects  this  command.  Sec  the  examples  under 
Type,  Same,  and  t quals. 

Equals^  Displays  the  "open"  location  (sec  the  Type  command)  as  bits  or  as  a number  if 
the  current  output  mode  is  already  bits.  The  single  coded  character  effects  this 
command.  In  the  following  example  format  F2  has  been  declared  consisting  of  four 
half-word  fields. 

tt:  010:  00,01,02,03  # 010:  01  il\  Oil:  02,03,04,05  tf\  013;  06,07,00,01 

#1  017:  04,05,06,07 

Locah^  Finds  cells  in  a list  of  expression-ranges  that  contain  (or  do  not  contain)  a 
specified  value,  examining  only  those  bits  designated  by  an  optional  mask,  and  displays 
their  locations  and  contents,  permitting  each  displayed  value  to  be  replaced  if  the  list  is 
terminated  by  an  esenpn.  Ihc  comparison  value  and  mask  arc  expressions  terminated  by 
an  rsicnpr;  the  coruparison  value  defaults  to  "NON  0"  and  the  mask  defaults  to  all  I’s.  The 
search  is  performed  over  a list  of  ranges,  as  for  the  Type  command. 

ffI.nca\o  2(  (^vp^^^^lon)  or  NON  (oxprer.s Ion) ) <mfllch  valuo  drlaults  to  NON  0> 

^locate  NON  0^’^^  (:qthin,isk)  /'(optional-expression)  xmask  valup> 

^docato  NON  0 (with  mask)  ♦^•'^<not  zoro>  (In)  ?( (oxprer.s  Ion- ranqn)  - 1 i 1 ) 
opt ional-<f SC>  to-mndlfy 

^locate  NON  0 (with  mask)  <not  zorox  (In)  0:020^’' 

00:  01  01:  02  02:  03  • 07i  05  010:  04 


oil:  06 


012;  07 
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It  i'^  important  that  the  comparison  value,  the  mask,  and  the  data  be  properly  aliened.  For 
example, 

A/,ocau  070^*^  (Hith  070^*^  (In) 

displays  all  cells  from  0 through  31  whose  second  octal  digit  from  tlir  right  contains  all  I’s. 

When  the  command  Is  terminated  by  an  eurnpc  tlie  debugger  stops  after  each 
display  to  permit  replacement,  as  for  the  lype  command. 

#/,ocata  *’^^<^non-7oro>  (Mith  mask)  07^*^  (In)  0:020^^^  00:  OJ  » 

0J?i  07  .= 

H 


.lump-history.  Displays  the  most  recent  target-program  jumps  in  the  order  they  occurred. 
The  number  of  such  jumps  to  display  (taken  modulo  the  default  value)  may  be  supplied, 
^riionp-historq  /((expression)  or  (empty  <all>)) 

Jump- hi  story  .1^^ 

01000-0200(2  times)  0300-8100  § 

I valuate.  Prints  the  value  of  a single  expression.  It  has  no  ellect  on  the  open  location 
and  does  not  permit  reolacement. 

jrNou-symljols  <at>  070000<^»‘ 

jT/waluate  r 070000  f 


Storage 

Storage  commands  change  the  contents  of  designated  locations  without  displaying 
them  and  without  changing  the  '’open"  location.  The  storage  commands  are 

Clcai,  Clears  the  contents  of  a list  of  exi  ession-ranges  to  all  7rro  bits.  Clearing  an 
event  for  which  a breakpoint  has  been  established  causes  the  event  to  be  deactivated;  it 
may  be  reactivated  with  a Set  command.  This  may  be  of  benefit  when  a break-time 
program  has  been  associated  with  the  event  as  the  breakpoint  data-base  errtry  for  tliat 
event  is  not  affected. 

/Clo.ir  f 

Sr't.  Sets  the  contents  of  a list  of  expresc'on-ranges  to  the  value  of  an  expression  or  (on 
default)  to  all  one-bits.  If  the  list  is  terminated  by  an  esmpo,  a single  replacement 
( impression  is  accepted;  if  it  is  terminated  by  a return,  the  default  value  of  all  I’s  is  used. 
I he  replacement  expression  is  truncated  to  fit  iniO  the  designated  locations,  if  necessary. 
Setting  an  event  for  which  a breakpoint  has  not  been  established  (i.r.,  for  which  there  is 
no  entry  in  the  breakpoint  data  base)  causes  the  event  to  be  activated  for  a single 
occurrence  of  that  event  (with  no  break  program  associated),  after  which  the  event  is 
automatically  cleared. 
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TARGET  EXECUTION  STATE 

Inrp.rt  execution  is  initiated,  or  resumed,  throuph  explicit  commands  (exec  CiO, 
clebiipper  Go  or  Sinpic-step).  Execution  proceeds  until  a terminatinp  event  occurs,  caiisinp 
control  to  return  to  the  appropriate  f’RIM  command  level.  When  execution  terminates,  the 
entire  emulated  context  --  including  clocks  and  outstanding  10  operations  - is  cleanly 
frozen  until  the  next  time  execution  is  resumed.  Except  for  explicit  modifications  to  the 
context  made  by  the  user  at  the  command  level,  the  termination  and  subsequent 
resumption  of  execution  is  transparent  to  the  target  machine.  The  terminating  events  are 

Ihc  target  machine  halts  normally  or  is  interrupted  (by  the  emulator)  due  to  the 
occurrence  of  some  anomaly  condition.  A message  to  that  effect  is  generated.  Ihc 
anomalies  being  monitored  are  listed  in  the  tool-specific  user  guide. 

The  user  enters  an  nhori.  Ihe  abort  character  is  echoed  and,  after  execution  is 
stopped,  a status  message  is  output  indicating  the  point  of  interruption. 

Hie  emulator  detects  the  occurrence  of  a break  condition  established  by  the  user  via 
the  debugger  breakpoint  command.  The  establishment  of  breakpoints  and  the 
subsequent  interruption  of  execution  at  the  time  of  their  occurrence  is  the  primary 
program  debugging  tool  In  f*RlM. 

An  10  error  occurs.  A message  detailing  the  particular  device  involved  and  the  nature 
of  the  error  is  output.  10  errors  always  return  control  to  the  exec  stale;  tfic  error 
messages  and  their  meanings  are  listed  at  the  end  of  this  section. 

Wh('n  one  of  these  conditions  occurs,  it  is  logged  and  execution  continues  until  the  end  of 
th(’  current  cycle  of  the  target  emujator.  It  Is  therefore  possible  for  multiple  conditions  to 
result  in  a single  stop.  When  this  fs  the  cdse,  the  action  and  message  appropriate  to  cncli 
of  the  conditions  is  produced. 

When  a breakpoint  is  detected,  the  debug  program,  if  any,  associated  with  each 
breakpoint  is  executed  by  the  debugger  before  control  returns  to  the  command  level, 
bhould  come  break  program  terminate  without  a Go  --  or  should  there  be  some  break  with 
no  break  program  --  a message  describing  the  breal-.  ’s  output  and  Ihe  command  level  is 
eiilercd.  Otherwise,  execution  is  automatically  resumed;  the  user  receives  no  indication 
that  a breakpoint  occurred  unless  the  break  program  itself  produced  output. 

TARGET  I/O 

Ihe  target  machine  that  runs  in  PRIM  consists  of  a processor  (CPU)  in  some 
particular  configuralion  built  by  the  user  to  resemble  the  actual  configuration  required  l)y 
his  programs.  A configuration  is  built  --  before  execution  is  begun  by  installing 
pe  ripheral  devices  and  establishing  values  for  various  machine  options  (see  the  exec  Install 
and  Set  commands).  After  an  emulated  device  has  been  installed,  and  before  10  operations 
can  proceed  on  that  device,  a (1ENEX)  file  or  assignable  device  must  b('  associated  with 
that  emulated  device  (see  the  exec  Mount  command).  Subsequent  10  operations  addressed 
to  that  device  are  then  performed  on  the  mounted  file. 

A mounted  file  may  contain  either  direct  device  data  (binary)  or  ASCII  text;  in  the 
latter  case,  characters  arc  translated  between  ASCII  and  the  actual  device  character  set  as 
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Ihry  ate  proccGf.rd.  (If  the  device  character  set  docs  not  include  lower  case,  input  lov/er 
i.i.e  letters  are  converted  to  upper  case  before  translation.)  When  the  target  device  is  a 
I ecord-oriented  device  card  reader  or  punch)  and  the  file  is  ASCII,  then  each  record 
operation  is  performed  on  a line  of  the  ASCII  text  file,  including  truncation  and/or  blank 
padding  on  Input. 

Ihe  mount  option  'I'll IS-TEKhtIN/li  associates  the  user  terminal  (the  one  being 
used  to  communicate  with  PI^IM)  with  a given  device.  When  the  terminal  has  been 
mounted  on  some  device,  then  inpert  from  the  terminal  is  switched  between  PIdM  and  the 
t.irget  machine  every  time  execution  Is  resumed  and  terminated.  Ihe  intervention 
characters,  however,  retain  their  intervention  meanings,  lo  allow  the  full  ASCII  character 
set  to  be  input  to  the  target  device  from  the  terminal,  there  is  a rontrol-Khift  escape 
character  defined  during  target  execution,  lo  help  distinguish  PPIM  output  from  target 
output  directed  to  'I'll IS-TI'HM INALt  all  PRlM-generated  output  Is  prefixed  with  the 
herald  ''  at  the  beginning  of  a new  line.  This  applies  in  particular  lo  both  stopping 
messages  and  typeout  resulting  from  break-time  debugger  programs. 

I/O  ERROR  MESSAGES 

Vari.iLis  I/O  errors  may  occur.  When  any  one  occurs,  execution  - including  the 
error-generating  operation  --  is  suspended,  and  control  returns  to  the  PRIM  exec.  When 
execution  Is  next  resumed,  the  suspended  operatic  is  retried  unless  it  has  been  explicitly 
canceled  by  the  user  using  the  exec  Cancel  commano 

"I  lie  not  mounted." 

Ihe  indicated  device  has  no  file  mounted.  If  a file  is  mounted  before  execution  is  next 
resumed,  the  operation  will  be  performed  then-  (An  installed  device  to  which  no  10  is 
directed  need  not  have  a mounted  file  iff  order  lo  run.)  Ihc  operation  may  instead  he 
f ancclecl. 

this  message  is  also  produced  when  an  output  operation  occurs  on  a device  which  has 
been  mounted  for  input  only,  and  vice  versa.  Again,  a second  file  must  be  mounted  on 
the  appropriate  side  of  the  device  in  order  to  proceed  normally  with  Ihe  program. 

"I  ile  not  open." 

Ihe  indicated  device  has  an  inaccessible  file  mounted  on  it.  Ihe  device  must  cither  be 
reassigned  or  unmounted  and  then  mounted.  Ihe  situation  is  similar  to  ttie  case 
above,  except  for  the  possibility  of  reassigning. 

"Iii»j  roper  tape  format  detected." 

IlfsILX  files  which  arc  mounted  on  target  magnetic  tape  devices  are  encoded  in  a 
unique  internal  format  that  requires  such  files  lo  be  used  only  for  PIdM  magnetic  tape 
devices.  Ihr  mounted  file  is  inconsistent  with  that  format.  Ihe  cK'vice  must  he 
unmounted  and  replaced  with  a proper  tape  file. 

"Device  not  installed." 

A df'vice  that  is  referenced  by  the  program  is  not  installed.  Should  Ihc  missing  d(^vice 
he  required,  there  is  no  way  to  continue  this  session,  since  device  Installation  is  no 
longer  allowed.  Should  Ihc  reference  bo  a mistake,  execution  may  be  continued  down 
a different  path  (the  operation  will  be  automatically  canceled  when  execution  resumes). 
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"ASC^II  characlcr  nol  r(’fop.ni7rd  --  if.norrd." 

llie  last  character  read  from  the  ASCII  input  file  on  the  ck'sijinatcd  device  was  nol 
translatable  into  the  character  set  of  the  device.  The  character  has  been  skipped 
resumini;  execution  cause?  the  read  operation  to  continue  with  the  next 
character  in  the  file.  The  position  of  the  offending  character  in  the  file  may  be 
determined  via  the  exec  Filcstatus  command,  spccifyinp,  the  indicated  device. 


Any  other  error  indicates  a bu(\  either  in  the  emulator  or  in  PRIM 
reported. 


Such,  errors  should  bo 


